Getting Started

Install gip and run your first bulk git operation

CONTENTS

Installation

Download the latest binary from GitHub Releases and place it on your $PATH.

# Linux / macOS — make it executable
chmod +x gip
sudo mv gip /usr/local/bin/gip

# Verify
gip --version

Or build from source (requires Go 1.21+):

git clone https://github.com/enr/gip
cd gip
./.sdlc/build
# binary is placed in ./bin/gip

Create a config file

Create ~/.gip (YAML or JSON) listing the repositories you want to manage:

- name: frontend
  repository: "https://github.com/org/frontend.git"
  local_path: ~/projects/frontend
  tags: [work, js]

- name: dotfiles
  repository: "git@github.com:user/dotfiles.git"
  local_path: ~/dotfiles
  tags: [personal]

- name: legacy
  repository: "https://github.com/org/legacy.git"
  local_path: ~/projects/legacy
  pull_policy: never

See Configuration for all available fields.

First commands

Check the status of all repos:

gip status

Pull the latest changes:

gip pull

See which branch each repo is on:

gip branch

List all registered projects:

gip list

Filter by tag

Run any command against a tagged subset:

# only repos tagged "work"
gip status --tag work

# OR logic — repos tagged "js" or "personal"
gip pull --tag js,personal

Scan existing repos

If you already have repos cloned and want to generate a config file from them:

gip init ~/projects
# writes to ~/.gip by default

← Configuration