Skip to main content

Task tracking for AI agents

Claude, Cursor, Codex, Gemini—same backlog. Handoffs that work. Reviews that catch bugs.

go install github.com/marcus/td@latest
td usage
$ td usage
SESSION: claude-7f3a (started 2h ago)

FOCUSED: td-a1b2 "Add OAuth login" [in_progress]
Last handoff (1h ago):
Done: OAuth callback, token storage
Remaining: Refresh rotation, logout flow

REVIEWABLE (by this session):
td-c3d4 "Fix signup validation" [in_review]

OPEN (P1):
td-e5f6 "Rate limiting on API" [open]

Built for AI-agent workflows

Structured Handoffs

Capture done/remaining/decisions/uncertain. Next session doesn't guess.

Session Isolation

Different sessions must review. Catches "works on my context" bugs.

Query-Based Boards

Organize work with TDQ queries. View as swimlanes in the monitor.

Dependency Graphs

Model dependencies. Critical-path finds optimal unblocking sequence.

Epics

Track large initiatives spanning multiple issues with tree visualization.

Live Monitor

Real-time TUI dashboard watching agent activity across sessions.

How it works

You build the backlog. Agents work through it autonomously—in parallel, with handoffs and enforced review.

You
Agents
Create backlog
Define epics, break into tasks, set priorities
td create "OAuth login" -p P1
Pick up tasks
Start work, handle in parallel when unblocked
td start td-a1b2
Do handoffs
Record progress for next session to resume
td handoff --done "..." --remaining "..."
Submit for review
Different session must review—enforced isolation
td review td-a1b2
Review & approve
Verify work, request changes, or close
td approve td-a1b2
Monitor progress
Watch agents work across sessions in real-time
td monitor

Watch work happen in real-time

The live monitor shows current work, board swimlanes, and activity logs across all agent sessions.

td monitor — real-time TUI dashboard

Works with your agent

Any agent that can run shell commands works with td—coding, research, data pipelines, whatever.

Claude Code
Cursor
Codex
Gemini CLI
GitHub Copilot

Everything you need

CLI-first
SQLite local
Single binary
TDQ query language
Configurable boards
Critical path analysis
Multi-issue sessions
Git snapshots
Undo support
Analytics
File tracking
Sidecar integration

Get started in seconds

go install github.com/marcus/td@latest

Sister Projects

Haplab

Task management for AI-assisted development.

You might never open your editor again.

Record anything you see in your terminal.