README.md

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 your own AI key	npx gitdog@latest provider-keys set anthropic

Use npx gitdog@latest --help to explore commands. Add --json for scripts.

Use in CI

npx gitdog@latest keys create --name ci
npx --yes gitdog@0.2.2 --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.

---

Command reference · Gitdog · Report an issue