What problem does it solve?
ghq streamlines managing many local Git repositories by providing consistent clone, list, root, create, and remove operations under a unified root directory so repositories are easy to find, open, and update.
Core Features & Use Cases
- Clone repositories from GitHub or arbitrary git remotes using shorthand or full URLs and options for SSH, shallow clones, and pull updates.
- List and filter repositories with relative or absolute paths and integrate with fzf for quick selection and editor launching.
- Import existing local Git repositories into ghq-managed paths by deriving destination paths from origin URLs or placing them under a local namespace; includes safe checks to avoid overwrites.
- Configuration guidance for setting ghq roots in gitconfig and a short checklist to verify success.
Quick Start
Import the local repository at /path/to/repo into your ghq root, compute the destination from its origin URL if present, move it safely, and report the final path or any errors.