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

# Cursor

> Set up tk with Cursor for AI-powered issue tracking

Use tk with [Cursor](https://www.cursor.com/) to manage issues directly from your editor.

***

## Project Rules

Create a [`.cursor/rules.md`](https://cursor.com/docs/context/rules) file to give Cursor context about tk:

```markdown theme={null}
# Issue Tracking

This project uses **tk (ticket-rs)** for issue tracking.
Issues are stored as Markdown in `.tickets/`.

## Quick Commands

- `tk ready` - Find work with no blockers
- `tk list` - List all open issues
- `tk create "Title" -t task -p 2` - Create issue
- `tk close <id>` - Complete work
- `tk triage` - AI recommendations
- `tk dep add <blocked> <blocker>` - Add dependency

## Issue Format

Issues are Markdown files with YAML frontmatter:

\`\`\`markdown
---
status: open
type: feature
priority: 1
deps: [tk-abc123]
labels: [backend]
---
# Issue Title

Description here.
\`\`\`

## Status Values

- `open` - Ready to be worked on
- `in_progress` - Currently being worked on
- `blocked` - Waiting on dependencies
- `closed` - Completed

## Priority Levels

- P0 - Critical
- P1 - High
- P2 - Medium (default)
- P3 - Low
- P4 - Lowest
```

***

## MCP Integration

Install the [`ticket-mcp`](https://pypi.org/project/ticket-mcp/) [MCP](https://cursor.com/docs/context/mcp) server to give Cursor full access to your issues:

<Card title="Install MCP Server" icon="download" href="cursor://anysphere.cursor-deeplink/mcp/install?name=ticket-mcp&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyJ0aWNrZXQtbWNwIl19">
  One-click install for Cursor. Requires `uv` installed.
</Card>

<Accordion title="Manual installation">
  Add to `~/.cursor/mcp.json` or `.cursor/mcp.json`:

  ```json theme={null}
  {
    "mcpServers": {
      "ticket-mcp": {
        "command": "uvx",
        "args": [
          "ticket-mcp"
        ],
        "env": {}
      }
    }
  }

  ```
</Accordion>

This gives Cursor's AI direct access to create, update, and manage your issues.

***

## Workflow Tips

### Starting a Session

Ask Cursor: *"Run tk ready and show me what I should work on"*

### Creating Issues

Ask Cursor: *"Create a bug for the login timeout issue, priority 0"*

### Closing Work

Ask Cursor: *"Close tk-abc123, I just fixed it"*

### Checking Health

Ask Cursor: *"Run tk doctor and tell me if anything needs fixing"*

***

## Next Steps

<CardGroup cols={2}>
  <Card title="CLI Reference" icon="terminal" href="/cli-reference/commands">
    Full command documentation.
  </Card>

  <Card title="MCP Server" icon="plug" href="/integrations/mcp">
    Documentation MCP server setup.
  </Card>
</CardGroup>