Commands

tk init [OPTIONS]

tk create <TITLE> [OPTIONS]

# Simple task
tk create "Fix login bug" -t bug -p 0

# Feature with description
tk create "Add dark mode" -t feature -D "Support system preference detection"

# Task with dependencies
tk create "Deploy to production" -d tk-abc123,tk-def456

# Epic with labels
tk create "User authentication" -t epic -l backend,security

tk show <ID>

tk list [OPTIONS]

# All open issues
tk list

# Only bugs
tk list -t bug

# High priority only (P0-P1)
tk list -p 1

# In-progress issues
tk list -s in_progress

# Issues needing more context
tk list --sparse

tk update <ID> [OPTIONS]

tk update tk-abc123 -s in_progress -p 0
tk update tk-abc123 -a john --add-labels urgent

tk close <ID> [OPTIONS]

tk close tk-abc123 -r "Completed in PR #42"

tk launch <ID> [OPTIONS]

tk resolve <ID> [OPTIONS]

tk ready [OPTIONS]

tk dep add <BLOCKED> <BLOCKER>

# tk-abc123 is blocked by tk-def456
tk dep add tk-abc123 tk-def456

tk dep remove <BLOCKED> <BLOCKER>

tk dep tree <ID>

tk dep list <ID>

tk dep cycles

tk search <QUERY> [OPTIONS]

tk search "authentication login"

tk similar <ID> [OPTIONS]

tk duplicates [OPTIONS]

tk grep <PATTERN> [OPTIONS]

tk grep "TODO|FIXME" -i

tk prime [OPTIONS]

tk triage

tk priority

tk next

tk plan

tk insights

tk stats

tk export [OPTIONS]

tk compact [OPTIONS]

tk orphan [OPTIONS]

tk worktree <COMMAND>

tk github sync [OPTIONS]

tk github sync --pull --state open
tk github sync --push --dry-run

tk github status

tk linear sync [OPTIONS]

tk linear status

tk linear teams

tk config get <KEY>
tk config set <KEY> <VALUE>
tk config list
tk config unset <KEY>

tk config set github.token ghp_xxxxx
tk config set linear.api_key lin_api_xxxxx
tk config list

tk setup claude [OPTIONS]

tk hooks <COMMAND>

tk doctor [OPTIONS]

tk validate

tk lint [OPTIONS]

tk onboard

tk demo [OPTIONS]

# Run all tests
cargo test

# Run specific test suite
cargo test --lib              # Unit tests
cargo test --test '*'         # Integration tests
cargo test cli::helpers       # Helper tests

# Good: Explicit type and priority
tk create "Add feature" -t feature -p 1

# Avoid: Letting defaults apply
tk create "Something"  # Creates task with P2

# Always validate after adding deps
tk dep add tk-123 tk-456
tk validate  # Check for cycles

# Use dep tree to visualize
tk dep tree tk-123

# Use filters to reduce output
tk list -p 1 -t bug

# Use ready instead of list for next actions
tk ready -n 5

# Use triage for AI recommendations
tk triage

# Always use JSON format for parsing
tk -f json list | jq '.[] | .id'

# Check exit codes
if tk validate; then
  echo "All valid"
fi

# Use quotes for titles with spaces
tk create "Multi word title"

tk help create
tk create --help

tk help

tk --version
tk version