git-issues — Issues that move with your code<br>A git-native issue tracker
Issues that move<br>with your code
Never out of sync. No database, no server, no accounts — just Markdown files in your repo, version-controlled alongside your code.
go install github.com/steviee/git-issues@latest
Get Started
Read the Docs
0003-auth-refactor.md<br>status: in-progress<br>priority: critical
0002-session-timeout.md<br>status: open<br>priority: high
id: 1<br>title: "Fix login bug"<br>status: open<br>priority: critical<br>labels: [bug, auth]
Description and notes go here as free-form Markdown.
zsh — git-issues demo
Version Control
Always in sync
with your code
Your issues live in .issues/, right next to src/.<br>When you git checkout a branch, your issues come with it.<br>When you git bisect to find a bug, the issue state at that commit is exactly what you see.
Branch-aware<br>Issues follow branches. A feature branch has its own issues.
Bisect-friendly<br>git bisect shows the issue state at every commit in history.
History is truth<br>git log .issues/ shows exactly when and why things changed.
git log --oneline<br>a1b2c3d Fix auth bug<br>src/auth.go<br>.issues/0001-fix-login-bug.md
e4f5g6h Add dark mode toggle<br>src/ui/dark-mode.ts<br>.issues/0002-add-dark-mode.md
git show a1b2c3d:.issues/0001-fix-login-bug.md<br>id: 1<br>title: "Fix login bug"<br>status: closed<br>closed: 2026-03-04
Fixed in src/auth.go. Password validation now rejects empty strings.
.issues/0001-fix-login-bug.md<br>id: 1<br>title: "Fix login bug"<br>priority: medium<br>labels: [bug, auth]
Login schlägt bei leeren Passwörtern fehl.
~ vim .issues/0001-fix-login-bug.md — 3s ago
Plain Text
Plans change.
Your issues too.
No rigid forms. No API rate limits. No "can't edit because the server is down."<br>Issues are Markdown. Edit them in Vim, VS Code, or directly in the GitHub UI.
Plain text<br>YAML + Markdown. Every editor, every agent, every human can read it.
No lock-in<br>Want to leave? Delete issues, keep the .md files. Done.
Offline first<br>No network needed. Edit issues on a plane, in a tunnel, anywhere.
Features
Everything you need.
Nothing you don't.
Zero Infrastructure<br>One Go binary. No Docker, no server, no database. Install, run `issues init`, done.
AI-Native Workflow<br>`issues next`, `claim`, `done`. `.agent.md` gives agents full context. JSON output for automation.
Bidirectional Relations<br>`blocks`, `depends-on`, `related-to`, `duplicates`. Both sides sync automatically.
Auto-Staged<br>Every change is automatically `git add`-ed. Your issue state travels with the commit.
Kanban Board<br>Interactive TUI with Bubble Tea. `issues board` opens a full Kanban board in your terminal.
Human & Machine<br>`--format table` for humans, `--format json` for scripts, `--format ids` for pipes.
AI Agents
Built for<br>AI Agents
The issues next → claim → done workflow replaces manual task management for coding agents.
issues next<br>Find the next unblocked, highest-priority issue
issues claim<br>Mark as in-progress
Do the work<br>The agent implements
issues done<br>Close the issue, auto-staged for commit
.issues/.agent.md<br># git-issues agent context<br>## Schema<br>Each issue is a Markdown file with YAML frontmatter.
## Agent-Optimized Commands<br>issues next # next actionable issue<br>issues claim # mark in-progress<br>issues done # close and stage
## Recommended Workflow<br>1. issues next → get next issue<br>2. issues claim → mark started<br>3. Do the work<br>4. issues done → close
Commands<br>Everything you need
issues initInitialize .issues/ directory in current repo
issues newCreate with editor or inline flags
issues listFilter by status, priority, label; output as table/json/ids
issues showFull detail with resolved relations and blocker indicators
issues relateBidirectional dependency sync
issues boardInteractive Kanban in the terminal