A git-native issue tracker
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
0003-auth-refactor.md
status: in-progress
priority: critical
0002-session-timeout.md
status: open
priority: high
---
id: 1
title: "Fix login bug"
status: open
priority: critical
labels: [bug, auth]
---
Description and notes go here as free-form Markdown.
Version Control
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.
Issues follow branches. A feature branch has its own issues.
git bisect shows the issue state at every commit in history.
git log .issues/ shows exactly when and why things changed.
a1b2c3d Fix auth bug
src/auth.go
.issues/0001-fix-login-bug.md
e4f5g6h Add dark mode toggle
src/ui/dark-mode.ts
.issues/0002-add-dark-mode.md
git show a1b2c3d:.issues/0001-fix-login-bug.md
---
id: 1
title: "Fix login bug"
status: closed
closed: 2026-03-04
---
Fixed in src/auth.go. Password validation now rejects empty strings.
.issues/0001-fix-login-bug.md
---
id: 1
title: "Fix login bug"
priority: medium
labels: [bug, auth]
---
Login schlägt bei leeren Passwörtern fehl.
~ vim .issues/0001-fix-login-bug.md — 3s ago
Plain Text
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.
YAML + Markdown. Every editor, every agent, every human can read it.
Want to leave? Delete issues, keep the .md files. Done.
No network needed. Edit issues on a plane, in a tunnel, anywhere.
Features
One Go binary. No Docker, no server, no database. Install, run `issues init`, done.
`issues next`, `claim`, `done`. `.agent.md` gives agents full context. JSON output for automation.
`blocks`, `depends-on`, `related-to`, `duplicates`. Both sides sync automatically.
Every change is automatically `git add`-ed. Your issue state travels with the commit.
Interactive TUI with Bubble Tea. `issues board` opens a full Kanban board in your terminal.
`--format table` for humans, `--format json` for scripts, `--format ids` for pipes.
AI Agents
The issues next → claim → done workflow replaces manual task management for coding agents.
1
issues next
Find the next unblocked, highest-priority issue
2
issues claim <id>
Mark as in-progress
3
Do the work
The agent implements
4
issues done <id>
Close the issue, auto-staged for commit
Commands
此内容由惯性聚合(RSS阅读器)自动聚合整理，仅供阅读参考。 原文来自 — 版权归原作者所有。