commitdog

stop writing commit messages. let commitdog do it.

reads your staged diff · suggests conventional commits · you pick one · done

---

what is this?

You just finished coding. Now you have to write a commit message. You type "fix stuff" or "wip" or just mash the keyboard. Three weeks later you're reading git log and it's completely useless.

commitdog reads what you actually changed and writes the message for you. You pick one. Done in 5 seconds.

no AI. no internet needed. no config files. no API keys. single binary.

---

install

Linux and macOS

curl -fsSL https://aysdog.com/install-commitdog.sh | sh

Windows — open PowerShell as Administrator and run:

irm https://aysdog.com/install-commitdog.ps1 | iex

downloads the binary, adds it to PATH automatically. restart your terminal and commitdog just works.

build from source (needs Go 1.21+)

git clone https://github.com/aysdog/commitdog.git
cd commitdog
go build -o commitdog .
sudo mv commitdog /usr/local/bin/commitdog

---

first time setup (do this once)

commitdog setup

it will ask for:

1. your GitHub noreply email (find it at github.com/settings/emails)
2. a GitHub personal access token (create one at github.com/settings/tokens — classic token, repo + write:org scopes)

saved to ~/.config/commitdog/config.toml. never asked again.

---

daily use

# stage your changes like normal
git add .

# run commitdog instead of git commit
commitdog

  suggestions:

  1  feat(auth): add refreshToken and verifyToken
  2  feat: implement refreshToken in auth
  3  feat: update auth module

  [1/2/3] pick, [e] edit, [q] quit › 1

  ✓ committed: feat(auth): add refreshToken and verifyToken

  push to origin/main? [Y/n] ›
  pushing...
  ✓ pushed to origin/main

pick a number. press enter to push. that's the whole thing.

---

made a mistake? revert it

commitdog revert

  recent commits:

  1  63baabe  docs(dummy): update dummy       (2 minutes ago)
  2  3b7486d  feat(auth): add refreshToken    (1 hour ago)
  3  c90ace2  refactor: update 10 files       (6 hours ago)
  4  57f7669  refactor(docs): update docs     (6 hours ago)
  5  4403b0f  refactor: update 13 files       (6 hours ago)

  [1-5] pick, [e] enter hash, [q] quit › 1

  reverting 63baabe — docs(dummy): update dummy
  ⚠  this creates a new revert commit. continue? [Y/n] ›

  ✓ reverted 63baabe

  push to origin/main? [Y/n] ›
  ✓ pushed to origin/main

pick the bad commit. confirm. done. no git syntax needed.

---

starting a brand new project

no more going to GitHub, creating a repo, copying the URL, setting the remote. commitdog does all of it:

mkdir my-project
cd my-project
# add your files
commitdog init

  commitdog init

  ✓ connected as anirbanfaith

  push to personal or org? [P/o] › o
  org name › aysdog
  repo name [my-project] ›
  private or public? [P/u] › u

  ✓ repo created: github.com/aysdog/my-project

  suggestions:
  1  feat: initial project setup
  2  chore: initial commit

  [1/2] pick › 1

  ✓ committed: feat: initial project setup
  ✓ pushed

  live at github.com/aysdog/my-project

---

commands

command	what it does
commitdog	suggest commit message for staged changes
commitdog revert	pick from last 5 commits and revert
commitdog init	create a GitHub repo and do the first push
commitdog setup	configure email and GitHub token (do once)
commitdog --version	print version
commitdog --help	print help

---

how it figures out the message

commitdog parses git diff --staged and looks at:

what files changed?
  → source, test, config, docs, migration?

what functions were added or removed?
  → add refreshToken, remove oldAuth?

what patterns are in the diff?
  → error handling, logging, test cases?

what's the main folder/module?
  → auth, api, db?

then generates 2-3 variations in conventional commits format and lets you pick.

commit types it detects

what changed	type
new function added	feat
function removed	refactor
only tests changed	test
only docs/README	docs
error handling added	fix
config file changed	chore
dependencies updated	chore
migration file added	feat
debug logs removed	chore

languages supported

Go · JavaScript · TypeScript · Python · Ruby · Rust · Java · Kotlin

---

security

commitdog is designed to never leak your data.

concern	how it's handled
shell injection	all git commands use exec.Command with explicit args — no shell
token storage	saved with 0600 permissions — only you can read it
token in git ops	never used — SSH or HTTPS handles push, token only for API
diff size	capped at 200KB — no memory issues
commit messages	sanitized before passing to git
network	zero outbound connections except commitdog init (GitHub API)
dependencies	pure Go stdlib — no third-party packages

you can read the entire source in 20 minutes. nothing is hidden.

---

contributing

open an issue first. if it fits — open a PR.

the one rule: don't add telemetry.
everything else is negotiable.

---

part of aysdog

commitdog is part of aysdog — open-source tools for developers who hate bloat.

zero telemetry · self-hostable · single binary · MIT licensed