Git Repo

Git Repo

Git repository management and SourceGit GUI client integration.

Topics

Quick Reference

ghq Clone (automatic SourceGit registration)

When ghq get <url> is executed, the following happens automatically:

1. Clone the repository
2. Register in SourceGit (under the appropriate group)
3. Auto-create the group if it doesn't exist

Proceeds automatically without user confirmation

Detailed guide

SourceGit Management

Directly edit the SourceGit GUI client's configuration file to add repositories, create workspaces, rename folders, etc.

Key features:

• Add/remove repositories
• Create workspaces
• Sync ghq repositories
• Update paths on folder rename

Detailed guide

ghq Migration

Migrate regular Git repositories to ghq directory structure (~/ghq/host/group/repo/).

Key features:

• Automatic bare+worktree structure conversion
• Create symbolic links at original location
• Nested group support (host/group/subgroup/repo)

Detailed guide

Repo Patrol (batch inspection)

Batch inspect and clean up the status of repositories under ghq.

Key features:

• Parallel collection of status, stash, unpushed for all repositories
• Status-based processing (commit-splitter integration, stash pop, push)
• Optional fetch all at the end

Detailed guide

Common Workflow

1. Repository migration: Migrate to ghq structure with migrate topic
2. SourceGit update: Register new paths with sourcegit topic
3. Batch inspection: Clean up uncommitted/unpushed changes with patrol topic

Scripts

• ./scripts/repo-to-ghq.sh - Script to move repositories to ghq path