> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ticket-rs.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Install ticket-rs and create your first issue in 60 seconds

Get up and running with tk in under a minute.

***

## Installation

```bash theme={null}
curl -fsSL https://ticket-rs.io/install.sh | sh
```

Auto-detects your platform and installs the latest release.

Verify the installation:

```bash theme={null}
tk --version
```

***

## Initialize a Project

Navigate to your project directory and initialize ticket tracking:

```bash theme={null}
cd your-project
tk init
```

This creates a `.tickets/` directory where issues will be stored.

<Tip>
  Add `.tickets/` to your git repo. Issues are meant to be versioned alongside your code.
</Tip>

***

## Create Your First Issue

```bash theme={null}
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

<Check>
  tk outputs the new issue ID (e.g., `tk-abc123`) and file path.
</Check>

***

## View Issues

```bash theme={null}
# 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:

```bash theme={null}
# tk-abc123 is blocked by tk-def456
tk dep add tk-abc123 tk-def456
```

View the dependency tree:

```bash theme={null}
tk dep tree tk-abc123
```

***

## Close an Issue

```bash theme={null}
tk close tk-abc123
```

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

```bash theme={null}
tk resolve tk-abc123
```

***

## Get AI Recommendations

```bash theme={null}
# 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:

```bash theme={null}
tk setup claude
```

This adds `tk prime` to your SessionStart hook, giving Claude context about your project's issues.

<Card title="Learn More" icon="wand-magic-sparkles" href="/integrations/claude-code">
  See the full Claude Code integration guide.
</Card>

***

## Check Health

Run the doctor to verify your setup:

```bash theme={null}
tk doctor
```

This checks for:

* Valid `.tickets/` directory
* Orphaned dependencies
* Git hooks installation
* Claude integration status

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Dependencies" icon="diagram-project" href="/concepts/dependencies">
    Learn about structuring issue dependencies.
  </Card>

  <Card title="Stacks" icon="layer-group" href="/concepts/stacks">
    Organize issues into linear dependency chains.
  </Card>

  <Card title="Graph Analytics" icon="chart-network" href="/concepts/graph-analytics">
    Understand how tk prioritizes work.
  </Card>

  <Card title="CLI Reference" icon="terminal" href="/cli-reference/commands">
    Full command documentation with all options.
  </Card>

  <Card title="Python SDK" icon="python" href="/integrations/python">
    Use ticket-rs from Python code.
  </Card>

  <Card title="MCP Server" icon="plug" href="/integrations/mcp">
    Give AI assistants access to tk tools.
  </Card>
</CardGroup>