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

# Cline

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

Use tk with [Cline](https://cline.bot/) to manage issues from an autonomous AI coding agent in VS Code.

***

## What is Cline?

[Cline](https://cline.bot/) is an open-source autonomous AI coding agent for VS Code with Plan/Act modes. It can create and edit files, run terminal commands, and use MCP servers — making it a natural fit for tk-powered issue tracking. With 4M+ developers, Cline is one of the most popular AI extensions on the VS Code Marketplace.

***

## MCP Integration

Install the [`ticket-mcp`](https://pypi.org/project/ticket-mcp/) MCP server to give Cline direct access to your issues.

### Quick Setup

1. Open the Cline sidebar in VS Code
2. Click the **MCP Servers** icon (plug icon)
3. Click **Configure MCP Servers**
4. Add the ticket-mcp configuration:

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

<Accordion title="Config file location">
  The Cline MCP settings file is located at:

  * **macOS:** `~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`
  * **Linux:** `~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`
  * **Windows:** `%APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`
</Accordion>

<Accordion title="Requirements">
  **uv** installed via: `curl -LsSf https://astral.sh/uv/install.sh | sh`

  **Python** version 3.10 or higher (installed automatically by uv)

  **VS Code** with [Cline extension](https://marketplace.visualstudio.com/items?itemName=saoudrizwan.claude-dev) installed
</Accordion>

### Verify Installation

After saving the configuration, check the MCP Servers panel in Cline. The `ticket-mcp` server should show a green status indicator. Cline will now have access to all tk tools.

***

## Project Context

Create a `.clinerules` file in your project root to give Cline context about tk:

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

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

## Quick Commands

- `tk triage` - AI-powered recommendations and project health
- `tk ready` - Find issues with no blockers
- `tk create "Title" -t task -p 2` - Create issue
- `tk show <id>` - View issue details
- `tk close <id>` - Complete work
- `tk dep add <blocked> <blocker>` - Add dependency

## Workflow

1. Run `tk triage` at the start of a session
2. Use `tk claim <id>` before starting work
3. Use `tk resolve <id>` when done
```

***

## Auto-Approve Tools

To let Cline use tk tools without prompting for approval each time, add tool names to `alwaysAllow`:

```json theme={null}
{
  "mcpServers": {
    "ticket-mcp": {
      "command": "uvx",
      "args": ["ticket-mcp"],
      "alwaysAllow": [
        "ready",
        "list_issues",
        "show",
        "search",
        "triage",
        "stats"
      ],
      "disabled": false
    }
  }
}
```

<Tip>
  Only auto-approve read-only tools. Keep write operations like `create`, `update`, and `close` behind approval prompts for safety.
</Tip>

***

## Workflow Tips

### Starting a Session

Ask Cline: *"Run tk triage and tell me what I should work on"*

Cline will execute `tk triage` and present AI-powered recommendations.

### Plan Mode

Ask Cline: *"Plan a fix for tk-abc123, then implement it"*

Cline's Plan mode will analyze the issue, create a plan, then switch to Act mode to implement it.

### Creating Issues

Ask Cline: *"Create a bug for the broken search indexing, priority 1"*

Cline will run:

```bash theme={null}
tk create "Fix broken search indexing" -t bug -p 1
```

### Closing Work

Ask Cline: *"Resolve tk-abc123, the fix is in the latest commit"*

***

## Cline-Specific Features

<AccordionGroup>
  <Accordion title="Plan/Act Workflow">
    Use Cline's Plan mode to analyze a tk issue, then switch to Act mode to implement. Cline can read the issue description from `tk show`, plan the fix, and execute it autonomously.
  </Accordion>

  <Accordion title="MCP Marketplace">
    Cline's [MCP Marketplace](https://cline.bot/mcp-marketplace) provides one-click installation of MCP servers. Check if ticket-mcp is listed for even easier setup.
  </Accordion>

  <Accordion title="Context-Aware Issue Creation">
    Cline can analyze code changes in your working directory and create appropriately scoped tk issues with correct types, priorities, and dependency links.
  </Accordion>

  <Accordion title="Autonomous Workflows">
    Combine Cline's autonomous mode with tk to handle full workflows: triage issues, claim work, implement fixes, run tests, and resolve issues — all in a single session.
  </Accordion>
</AccordionGroup>

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="MCP server not connecting">
    Check that `uvx` is in your PATH. Open the Cline MCP Servers panel and verify the server shows a green status. Try clicking the restart button next to the server.
  </Accordion>

  <Accordion title="Tools not appearing">
    Ensure `"disabled": false` in your config. Restart VS Code after editing the MCP settings file. Check Cline's output panel for error messages.
  </Accordion>

  <Accordion title="Too many approval prompts">
    Add read-only tool names to the `alwaysAllow` array in your MCP config. See the Auto-Approve section above.
  </Accordion>

  <Accordion title="Slow tk commands">
    Enable caching with `tk cache info` to verify the analytics cache is working. Cached responses return in under 10ms.
  </Accordion>
</AccordionGroup>

***

## Next Steps

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

  <Card title="MCP Server" icon="plug" href="/integrations/mcp">
    Deep dive into MCP server capabilities
  </Card>

  <Card title="Graph Analytics" icon="chart-network" href="/concepts/graph-analytics">
    Learn about PageRank and dependency analysis
  </Card>

  <Card title="Cline Docs" icon="book" href="https://docs.cline.bot/">
    Official Cline documentation
  </Card>
</CardGroup>

***

## Sources

* [Cline Documentation](https://docs.cline.bot/)
* [Cline MCP Server Configuration](https://docs.cline.bot/mcp/configuring-mcp-servers)
* [Cline MCP Marketplace](https://cline.bot/mcp-marketplace)
* [MCP Documentation](https://modelcontextprotocol.io)