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

​
Installation

Auto-detects your platform and installs the latest release. Verify the installation:

​
Initialize a Project

Navigate to your project directory and initialize ticket tracking:
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

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

​
Add Dependencies

Create a blocking relationship between issues:
View the dependency tree:

​
Close an Issue

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

​
Get AI Recommendations

​
Set Up AI Integration

For Claude Code users, install hooks to auto-inject context:
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:
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.