ticket
The git-backed issue tracker for AI agents. tk is inspired by the Joe Armstrong post Minimal Viable Program with additional quality of life features for managing and querying against complex issue dependency graphs.
tk was written as a full replacement for beads. It shares many similar commands but without the need for keeping a SQLite file in sync or a rogue background daemon mangling your changes. It ships with a migrate-beads command to make this a smooth transition.
Tickets are markdown files with YAML frontmatter in .tickets/ . This allows AI agents to easily search them for relevant content without dumping ten thousand character JSONL lines into their context window.
Using ticket IDs as file names also allows IDEs to quickly navigate to the ticket for you. For example, you might run git log in your terminal and see something like:
nw-5c46: add SSE connection management
VS Code allows you to Ctrl+Click or Cmd+Click the ID and jump directly to the file to read the details.
Install
Homebrew (macOS/Linux):
brew tap wedow/tools brew install ticket
... continue reading