Gitdog CLI
Your GitHub assistant. Now in the terminal.
Connect repositories, configure issue, discussion and PR automation, review AI actions, and manage project tasks from your terminal or CI.
Run with npx
Requires Node.js 22.14+. No global installation needed.
npx gitdog@latest --help
Quick start
npx gitdog@latest login
npx gitdog@latest github install
npx gitdog@latest github recover
npx gitdog@latest init owner/repo
npx gitdog@latest config set requireApproval true
npx gitdog@latest config set pullRequestReviewsEnabled true
npx gitdog@latest config set requireApprovalForPullRequests true
npx gitdog@latest config push
GitHub App setup is only needed once. A project connects an existing GitHub repository to Gitdog.
Everyday commands
| Task | Command |
|---|---|
| List projects | npx gitdog@latest projects list |
| Read automation settings | npx gitdog@latest config get --remote |
| Review pending actions | npx gitdog@latest tickets pending |
| Check code indexing | npx gitdog@latest index status |
| List team members | npx gitdog@latest team members |
| Check usage | npx gitdog@latest usage summary |
Use npx gitdog@latest --help to explore commands. Add --json for scripts.
Use in CI
npx gitdog@latest keys create --name ci
npx --yes [email protected] --key-file /path/to/key.json projects list --json
npx gitdog@latest keys revoke KEY_ID --yes
keys create prints the private key file's path. Keys are project-scoped and
read-only by default; add --write for settings and ticket delete/restore. Keep key
files out of Git.