Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Supported AI CLIs

git-paw auto-detects these AI coding CLIs on your PATH:

CLIBinaryDescriptionInstall
Claude CodeclaudeAnthropic’s AI coding assistantnpm i -g @anthropic-ai/claude-code
CodexcodexOpenAI’s coding agentnpm i -g @openai/codex
Gemini CLIgeminiGoogle’s Gemini in the terminalnpm i -g @anthropic-ai/gemini-cli
AideraiderAI pair programming in the terminalpip install aider-chat
VibevibeMistral AI’s coding CLISee project docs
QwenqwenAlibaba’s Qwen coding CLISee project docs
AmpampSourcegraph’s AI coding agentSee project docs

How Detection Works

git-paw scans your PATH for each known binary name. If found, it records the full path and makes the CLI available for selection.

Detection runs every time you start a session, so newly installed CLIs are picked up automatically.

Adding Custom CLIs

Any AI CLI not in the list above can be registered as a custom CLI:

# Register by path
git paw add-cli my-agent /usr/local/bin/my-agent

# Register by binary name (resolved via PATH)
git paw add-cli my-agent my-agent --display-name "My Agent"

Custom CLIs appear alongside detected ones in the selection prompt. See Configuration for more details.

Deduplication

If a custom CLI has the same binary name as a detected one, the custom definition takes precedence. This lets you override the path or display name of a detected CLI.

Missing CLIs

If a custom CLI’s command cannot be found (the binary doesn’t exist at the specified path and isn’t on PATH), it is excluded from the selection list with a warning. This prevents launching sessions that would immediately fail.