gh-q

🔹Report Bug     🔹Request Feature

$ gh q --help
Usage:
  gh q get <repo>     ... Clone a repository into ~/ghq/github.com
  gh q list           ... List all repositories in ~/ghq/github.com
  gh q <command>      ... Search via fzf and run <command> with selected directory as argument

Usage

# Install
gh extension install HikaruEgashira/gh-q

# ghq get owner/repo equivalent to
gh q get owner/repo

Shell Completion

# Zsh - Add to ~/.zshrc
source <(gh q completion zsh)

# Bash - Add to ~/.bashrc
source <(gh q completion bash)

# Fish - Run once
gh q completion fish > ~/.config/fish/completions/gh-q.fish

fzf Native Integration

Path Argument Mode

Passes the selected directory path as an argument to the command.

gh q code        # Opens VS Code with the selected directory

Directory Change Mode

Changes to the selected directory first, then executes the command.

gh q -- claude        # Run Claude Code in the selected directory
gh q --               # Opens a shell in the selected directory

Blog post

[gh-q] gh extensionでghqを置き換える - Zenn

Acknowledgements

Works well with:

• gh-wt: Git worktree management
• gh-ws: VSCode workspace management with worktrees

# Example workflow
gh q                    # Select repository
gh wt add feature/new   # Create new worktree
gh ws init              # Create/update workspace