issues
Keep agent work scoped, durable, and reviewable.
A lightweight, self-hosted issue tracker designed around AI-agent development loops.
CURRENT iss-42 Add product landing page STATUS in_progress BRANCH issue/iss-42 LATEST HANDOFF done product shell and responsive layout remaining capture interface assets READY 3 unblocked issues
issues keeps agent work scoped, durable, and close to the repository. It treats a useful issue as an execution boundary: small enough to review, large enough to produce a coherent result, and explicit enough to hand off between people and agents.
The tool combines a local issue queue with ownership, dependencies, worktree-aware execution, and a handoff trail. It is intentionally smaller than a team project-management system and more durable than conversation history.
What the interface makes visible.
Session context
Give each new agent enough current state to continue without reconstructing a chat transcript.
Structured handoffs
Record what changed, what remains, and which decisions must survive the next context reset.
Ready work
Expose the next unblocked task instead of asking a person to redirect every new session.
Worktree isolation
Connect active work to a branch and worktree so concurrent agents have explicit boundaries.
Repo-aware coordination
Keep project configuration near each repository while one lightweight server coordinates repos, machines, and agents.
Scriptable output
Return structured JSON for agents and automation without scraping an interactive interface.
Move from the broad view to the useful detail.
- 01
Choose
Find the next unblocked issue and inspect the context around it.
issues next - 02
Start
Claim the task and create an isolated place for the work when needed.
issues start <id> - 03
Hand off
Preserve completed work, remaining work, decisions, and uncertainty.
issues handoff <id> - 04
Finish
Merge the branch, close the issue, and remove the temporary worktree deliberately.
issues done <id> --merge --rm