> ## 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.

# Introduction

> AI-native issue tracking. Git-backed. Dependency-aware. Zero daemons.

<img src="https://mintcdn.com/stardust-d1398d07/Arp9VD_rajOvJIXp/images/hero.png?fit=max&auto=format&n=Arp9VD_rajOvJIXp&q=85&s=4529fb0c6039ef7740a2c20872b8c1d8" alt="tk" width="100%" href="https://ticket-rs.io" data-path="images/hero.png" />

**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

<img src="https://mintcdn.com/stardust-d1398d07/OpxCsdL57eSjekUO/images/how-it-works.png?fit=max&auto=format&n=OpxCsdL57eSjekUO&q=85&s=c6f847a0c3b62baca2becd7c36470e21" alt="How ticket-rs works" width="100%" data-path="images/how-it-works.png" />

**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.

<CardGroup cols={2}>
  <Card title="Git-Backed" icon="code-branch">
    Issues live in your repo as Markdown files. No external database, no sync conflicts.
  </Card>

  <Card title="Dependency-Aware" icon="diagram-project">
    Track blocking relationships. PageRank surfaces what matters most.
  </Card>

  <Card title="AI-Native" icon="robot">
    Built for AI agents with `tk prime`, `tk triage`, and MCP integration.
  </Card>

  <Card title="Zero Daemons" icon="bolt">
    No background processes. Just a single binary that works instantly.
  </Card>
</CardGroup>

***

## Quick Example

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

```markdown theme={null}
---
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
* **Stacks** — Detect linear dependency chains for coordinated development

<Card title="Learn about Concepts" icon="lightbulb" href="/concepts/dependencies">
  Dive into dependencies, stacks, and graph analytics.
</Card>

### 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

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Install tk and create your first issue in 60 seconds.
  </Card>

  <Card title="CLI Reference" icon="terminal" href="/cli-reference/index">
    Complete command documentation.
  </Card>

  <Card title="Claude Code Setup" icon="wand-magic-sparkles" href="/integrations/claude-code">
    Configure tk with Claude Code hooks.
  </Card>

  <Card title="GitHub Sync" icon="github" href="/integrations/github">
    Sync issues with GitHub Issues.
  </Card>
</CardGroup>