| name | tk |
| description | Git-backed ticket management for AI agents |
tk - Ticket Management
A minimal CLI for tracking tickets as markdown files in .tickets/.
Workflow
tk ready
tk start <id>
tk show <id>
tk close <id>
Core Commands
| Command | Description |
|---|
tk create "title" | Create ticket (returns ID) |
tk show <id> | View ticket details |
tk start <id> | Claim ticket (set to in_progress) |
tk close <id> | Complete ticket |
tk reopen <id> | Revert to open |
tk edit <id> | Open in $EDITOR |
Listing & Filtering
tk list
tk list --status open
tk list -a alice
tk list -T urgent
tk ready
tk blocked
tk closed
Create Options
tk create "Fix login bug" \
-d "Description text" \
-t bug \
-p 1 \
-a alice \
--parent <epic-id> \
--tags ui,urgent
Dependencies
tk dep add <id> <depends-on>
tk dep remove <id> <dep-id>
tk dep tree
tk dep check
Notes & Links
tk add-note <id> "Progress update"
tk link <id1> <id2>
tk unlink <id1> <id2>
Export
tk query
tk query '.[] | .title'
Tips
- Partial ID matching:
tk show a1b matches tic-a1b2c3
- Tickets stored in
.tickets/ as markdown with YAML frontmatter
- Git-friendly: commit tickets with your code