Skip to main content
tk ticket-rs (tk) is a fast, dependency-aware issue tracker designed for AI-native workflows. Issues are stored as Markdown files with YAML frontmatter in .tickets/, making them versionable, greppable, and diff-friendly.

​
How It Works

👨‍💻
Developer
architect & review
👔
PMs & Designers
create issues
External Trackers
Linear
GitHub Issues
JIRA (roadmap)
🎟️
ticket-rs
.tickets/*.md
🤖
Local AI Agent
Claude Code • Cursor
triage • build • test
☁️
GitHub
code + .tickets/
Clone and Go
git clone gives you everything — code AND tickets
No API keys • No external queries • Complete offline capability
The flow:
  1. Clone and Go: git clone gives you everything — code AND tickets. No API keys, no external queries. The complete project state is in the repo.
  2. Local Agents: Each developer has their own local AI agent (Claude Code, Cursor) working directly with their cloned repo. Run tk triage, build, test, and commit — all locally.
  3. External Sync: PMs create issues in Linear/GitHub/JIRA. tk sync keeps external trackers and local .tickets/*.md files in sync bidirectionally.
  4. Git Workflow: Push commits (code + ticket updates) to GitHub. Other team members pull and get the latest state automatically.
  5. Status Updates: Close issues locally (via AI or human). Status syncs back to external trackers automatically.

Git-Backed

Issues live in your repo as Markdown files. No external database, no sync conflicts.

Dependency-Aware

Track blocking relationships. PageRank surfaces what matters most.

AI-Native

Built for AI agents with tk prime, tk triage, and MCP integration.

Zero Daemons

No background processes. Just a single binary that works instantly.

​
Quick Example

# Initialize ticket tracking
tk init

# or if you're coming from beads (bd):
tk migrate-beads

# Create an issue
tk create "Add user authentication" -t feature -p 1

# Add a dependency
tk dep add tk-abc123 tk-def456  # abc123 is blocked by def456

# Find ready work (no open blockers)
tk ready

# Get AI-powered recommendations
tk triage

​
Issue File Format

Issues are Markdown files in .tickets/ with YAML frontmatter: 
---
status: open
type: feature
priority: 1
deps: [tk-def456]
labels: [backend, auth]
---
# Add user authentication

Implement OAuth2 login flow with Google and GitHub providers.

## Acceptance Criteria
- [ ] Google OAuth working
- [ ] GitHub OAuth working
- [ ] Session persistence

​
Key Features

​
Graph Analytics

tk uses graph algorithms to help you prioritize:
  • PageRank — Issues that unblock the most work bubble up
  • Critical Path — Find the longest dependency chain
  • Betweenness Centrality — Identify bottleneck issues

​
AI Agent Integration

Designed for Claude Code, Cursor, and other AI assistants:
  • tk prime — Inject workflow context at session start
  • tk triage — Unified recommendations, quick wins, blockers
  • tk next — Single top recommendation for quick decisions

​
External Sync

Bidirectional sync with your existing tools:
  • GitHub Issues — tk github sync
  • Linear — tk linear sync

​
Next Steps

Quickstart

Install tk and create your first issue in 60 seconds.

CLI Reference

Complete command documentation.

Claude Code Setup

Configure tk with Claude Code hooks.

GitHub Sync

Sync issues with GitHub Issues.