ghq

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.