ghq

Manage local Git repositories with centralized clone, list, and import operations.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/swat9013/dotfiles --skill ghq
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ghq
Source: https://github.com/swat9013/dotfiles/tree/main/.claude-global/skills/ghq
Command: npx skills add https://github.com/swat9013/dotfiles --skill ghq

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about ghq

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I organize local Git repositories into a single root directory?

Organize local Git repositories by centralizing clone, list, and import operations into a single ghq root directory. This ensures repositories are consistently structured, easy to find, and simple to open or update.

How do I import an existing local Git repository into ghq-managed paths?

Import existing local Git repositories by deriving the destination path from the repository's origin URL or placing it under a local namespace. Safe checks prevent overwriting, and the final path or any errors are reported.

Can I clone GitHub repositories using SSH or HTTPS remote URLs with shallow clone options?

Clone GitHub repositories using shorthand or full URLs with support for both SSH and HTTPS remote formats. Shallow clones and pull updates are supported to streamline the cloning process.

Does ghq work with fzf for listing and filtering repositories?

Yes, ghq integrates with fzf for quick selection when listing and filtering repositories. You can launch selected repositories directly via editor integrations using relative or absolute paths.

What is the best way to manage many cloned Git repositories across different GitHub projects?

Manage many cloned Git repositories by applying consistent clone, list, root, create, and remove operations under a unified root directory. This approach keeps repositories organized and easy to update across projects.