Skip to main content
Get up and running with tk in under a minute.

​
Installation

curl -fsSL https://ticket-rs.io/install.sh | sh
Auto-detects your platform and installs the latest release. Verify the installation: 
tk --version

​
Initialize a Project

Navigate to your project directory and initialize ticket tracking: 
cd your-project
tk init
This creates a .tickets/ directory where issues will be stored.
Add .tickets/ to your git repo. Issues are meant to be versioned alongside your code.

​
Create Your First Issue

tk create "Set up CI/CD pipeline" -t task -p 1
Options:
  • -t / --type — Issue type: task, feature, bug, epic, spike, chore
  • -p / --priority — Priority level: 0 (critical) to 4 (lowest)
  • -d / --deps — Comma-separated blocking dependencies
  • -l / --labels — Comma-separated labels
tk outputs the new issue ID (e.g., tk-abc123) and file path.

​
View Issues

# List all open issues
tk list

# Show details for a specific issue
tk show tk-abc123

# Find issues ready to work on (no blockers)
tk ready

​
Add Dependencies

Create a blocking relationship between issues: 
# tk-abc123 is blocked by tk-def456
tk dep add tk-abc123 tk-def456
View the dependency tree: 
tk dep tree tk-abc123

​
Close an Issue

tk close tk-abc123
Or use tk resolve to close and see what work is now unblocked: 
tk resolve tk-abc123

​
Get AI Recommendations

# Unified triage: quick wins, blockers, health score
tk triage

# PageRank-based priority recommendations
tk priority

# Single top recommendation
tk next

​
Set Up AI Integration

For Claude Code users, install hooks to auto-inject context: 
tk setup claude
This adds tk prime to your SessionStart hook, giving Claude context about your project’s issues.

Learn More

See the full Claude Code integration guide.

​
Check Health

Run the doctor to verify your setup: 
tk doctor
This checks for:
  • Valid .tickets/ directory
  • Orphaned dependencies
  • Git hooks installation
  • Claude integration status

​
Next Steps

Dependencies

Learn about structuring issue dependencies.

Stacks

Organize issues into linear dependency chains.

Graph Analytics

Understand how tk prioritizes work.

CLI Reference

Full command documentation with all options.

Python SDK

Use ticket-rs from Python code.

MCP Server

Give AI assistants access to tk tools.