Issues that move
with your code
Never out of sync. No database, no server, no accounts — just Markdown files in your repo, version-controlled alongside your code.
Always in sync
with your code
Your issues live in .issues/, right next to src/.
When you git checkout a branch, your issues come with it.
When you git bisect to find a bug, the issue state at that commit is exactly what you see.
Branch-aware
Issues follow branches. A feature branch has its own issues.
Bisect-friendly
git bisect shows the issue state at every commit in history.
History is truth
git log .issues/ shows exactly when and why things changed.
Plans change.
Your issues too.
No rigid forms. No API rate limits. No "can't edit because the server is down." Issues are Markdown. Edit them in Vim, VS Code, or directly in the GitHub UI.
Plain text
YAML + Markdown. Every editor, every agent, every human can read it.
No lock-in
Want to leave? Delete issues, keep the .md files. Done.
Offline first
No network needed. Edit issues on a plane, in a tunnel, anywhere.
Everything you need.
Nothing you don't.
Zero Infrastructure
One Go binary. No Docker, no server, no database. Install, run `issues init`, done.
AI-Native Workflow
`issues next`, `claim`, `done`. `.agent.md` gives agents full context. JSON output for automation.
Bidirectional Relations
`blocks`, `depends-on`, `related-to`, `duplicates`. Both sides sync automatically.
Auto-Staged
Every change is automatically `git add`-ed. Your issue state travels with the commit.
Kanban Board
Interactive TUI with Bubble Tea. `issues board` opens a full Kanban board in your terminal.
Human & Machine
`--format table` for humans, `--format json` for scripts, `--format ids` for pipes.
Built for AI Agents
The issues next → claim → done workflow replaces manual task management for coding agents.
Find the next unblocked, highest-priority issue
Mark as in-progress
The agent implements
Close the issue, auto-staged for commit