Skip to content
hyodotdevPublic

About

Manage Gitdog projects, GitHub automation and API keys from your terminal

Topics

Resources

Contributing

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

Gitdog

Gitdog

The codebase-aware assistant for GitHub issues, discussions and pull requests.
Grounded in your repository. Published only when you approve.

Website Web CI CLI CI npm

Website · CLI · AI models · Contributing · Issues


Why Gitdog

Maintainers answer the same questions, triage vague reports and review routine changes every day. Gitdog indexes your repository and drafts the work for you — with the actual code as evidence, not generic advice.

What it does
Issue assistant Turns rough reports into clear, structured issues and answers questions
Discussion assistant Replies to GitHub Discussions with context from your codebase
Pull request reviews Reviews changed code against the repository and suggests concrete fixes
Maintainer tagging Notifies the right people when a request needs a code change
Approval first With approval on (the default), drafts wait in your queue until you approve them
Team workspace Share projects with members and keep per-project settings and usage in one place

How it works

flowchart LR
    A[GitHub issue, discussion<br/>or pull request] --> B[Gitdog]
    B --> C[(Repository index<br/>embeddings + keyword search)]
    C --> D[AI draft with<br/>source evidence]
    D --> E{Your approval}
    E -->|Approve| F[Comment or review<br/>on GitHub]
    E -->|Request changes| D
Loading
  1. Connect a repository through the Gitdog GitHub App.
  2. Index — Gitdog builds a searchable index of your code and keeps it in sync with the default branch.
  3. Draft — new issues, discussions and pull requests get a reply or review grounded in the indexed source.
  4. Approve — review the draft in Gitdog or the CLI, then publish it.

Get started

On the web — sign in with GitHub at gitdog.dev, install the GitHub App and connect a repository. The Free plan includes 100K tokens per month; no credit card required.

From the terminal — the gitdog CLI manages projects, settings and approvals:

npx gitdog@latest login
npx gitdog@latest init owner/repo
npx gitdog@latest tickets pending

Repository layout

This is a monorepo managed with bun workspaces.

Path Description
src/ Web app — React 19, TypeScript, Tailwind CSS
convex/ Backend — Convex functions, GitHub App, AI workflows and billing
packages/cli/ The gitdog CLI, published to npm
docs/ Conventions, GitHub App setup and AI model notes

Development

Requires Node.js 26 (nvm use) and Bun 1.4.4.

bun install
cp .env.example .env.local
bun run dev
Command Purpose
bun run dev Run the web app and Convex dev backend together
bun run typecheck Type-check the web app, backend and e2e runners
bun run lint ESLint across the monorepo
bun run test Web and backend test suites
bun run test:cli CLI test suite
bun run check:api Verify the CLI API catalog matches the backend

See CONTRIBUTING.md before opening a pull request.

Tech stack

Layer Technology
Frontend React 19, TypeScript, Vite, Tailwind CSS, react-i18next (en, ko, ja)
Backend Convex
AI Claude Sonnet 5.5 with GPT-6.1 Sol fallback; OpenAI embeddings
GitHub GitHub App (OAuth, webhooks, repository access)
Payments Lemon Squeezy
Hosting Firebase Hosting

Documentation

Security

Please report security issues privately to hyo@hyo.dev instead of opening a public issue.

License

This repository is currently marked UNLICENSED in package.json.

About

Manage Gitdog projects, GitHub automation and API keys from your terminal

Topics

Resources

Contributing

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages