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

# Claude Cowork

> Set up tk with Claude Cowork for AI-powered issue tracking

Use **tk** with [Claude Cowork](https://claude.com/resources/tutorials/claude-cowork-a-research-preview) to give Claude access to your project's issues, dependencies, and priorities — directly in your AI conversations.

***

## What is Claude Cowork?

**Claude Cowork** is a browser-based workspace where you can upload files and chat with Claude about your project. Unlike the standard Claude chat:

* ✅ Upload custom binaries and run them
* ✅ Work with multiple files simultaneously
* ✅ Access a full sandboxed environment
* ✅ No local setup required

This makes it perfect for using **tk** to manage issues when you're away from your development machine.

***

## Why Use tk with Claude Cowork?

<CardGroup cols={2}>
  <Card title="Quick Triage" icon="list-check">
    Ask Claude to run `tk triage` and get AI recommendations without leaving the browser
  </Card>

  <Card title="Issue Management" icon="clipboard-list">
    Create, update, and close issues through natural language
  </Card>

  <Card title="Dependency Analysis" icon="diagram-project">
    Visualize issue dependencies and critical paths
  </Card>

  <Card title="No Local Install" icon="cloud">
    Use tk from any device without installing anything
  </Card>
</CardGroup>

***

## Setup Instructions

### Step 1: Download the tk Binary

Download the **Linux ARM64** binary (Claude Cowork runs on ARM64 architecture):

```bash theme={null}
# On your local machine visit the direct download URL:
https://ticket-rs.io/bin/tk-linux-aarch64
```

> This will download the `tk-linux-aarch64` binary to your downloads folder.

Or download directly from the [install page](https://ticket-rs.io/install).

<Tip>
  Claude Cowork uses **Linux ARM64**. Make sure you download the correct architecture.
</Tip>

***

### Step 2: Upload the Binary to Claude Cowork

1. Go to [claude.ai/cowork](https://claude.ai/cowork)
2. Click the **"Add Files"** button in the sidebar

<img src="https://mintcdn.com/stardust-d1398d07/q7hpM1J52GPC3ihH/images/claude/cowork/add-files.png?fit=max&auto=format&n=q7hpM1J52GPC3ihH&q=85&s=9cad2b13750ad09b9e9970228091f747" alt="Add files button in Claude Cowork" width="1578" height="698" data-path="images/claude/cowork/add-files.png" />

1. Select the `tk` binary you downloaded
2. Wait for the upload to complete

<img src="https://mintcdn.com/stardust-d1398d07/q7hpM1J52GPC3ihH/images/claude/cowork/upload-tk.png?fit=max&auto=format&n=q7hpM1J52GPC3ihH&q=85&s=0321b57b4d2880c7eabae5770dcf2d19" alt="Upload tk binary" width="1290" height="1330" data-path="images/claude/cowork/upload-tk.png" />

***

### Step 3: Make the Binary Executable

Once uploaded, ask Claude to make it executable:

```
@tk make this binary executable
```

Claude will run:

```bash theme={null}
chmod +x tk
./tk --version
```

<img src="https://mintcdn.com/stardust-d1398d07/q7hpM1J52GPC3ihH/images/claude/cowork/run-tk.png?fit=max&auto=format&n=q7hpM1J52GPC3ihH&q=85&s=766b6c9c967f165bab96e1cb6eeed705" alt="Make tk executable and run it" width="1534" height="1782" data-path="images/claude/cowork/run-tk.png" />

<Check>
  If you see the version output, tk is ready to use!
</Check>

***

### Step 4: Upload Your `.tickets/` Directory

Upload your project's `.tickets/` directory so Claude can analyze your issues:

1. Zip your `.tickets/` folder locally:

```bash theme={null}
zip -r tickets.zip .tickets/
```

1. Upload `tickets.zip` to Claude Cowork
2. Ask Claude to extract it:

```
Extract tickets.zip
```

<img src="https://mintcdn.com/stardust-d1398d07/51CM4tqVBKzhxqZY/images/claude/cowork/demo.png?fit=max&auto=format&n=51CM4tqVBKzhxqZY&q=85&s=a2f7b8386bd89a2e4a364ee859c681f8" alt="Using tk with Claude in Cowork" width="2428" height="1868" data-path="images/claude/cowork/demo.png" />

***

## Usage Examples

Now you can ask Claude to run tk commands naturally:

<AccordionGroup>
  <Accordion title="Get AI-powered triage recommendations">
    **You:** "Run tk triage and tell me what I should work on"

    **Claude:** Runs `./tk triage` and interprets the results, explaining the top recommendations and why they matter.
  </Accordion>

  <Accordion title="Create a new issue">
    **You:** "Create a new issue for adding OAuth authentication, priority 1, type feature"

    **Claude:** Runs `./tk create "Add OAuth authentication" -p 1 -t feature` and confirms the new issue ID.
  </Accordion>

  <Accordion title="Check what's ready to work on">
    **You:** "What issues are ready to work on right now?"

    **Claude:** Runs `./tk ready` and shows you all unblocked issues.
  </Accordion>

  <Accordion title="Visualize dependencies">
    **You:** "Show me the dependency tree for tk-abc123"

    **Claude:** Runs `./tk dep tree tk-abc123` and explains the relationships.
  </Accordion>

  <Accordion title="Analyze project health">
    **You:** "How healthy is this project? Any bottlenecks?"

    **Claude:** Runs `./tk insights` and explains PageRank, betweenness centrality, and critical path findings.
  </Accordion>
</AccordionGroup>

***

## Best Practices

<Steps>
  <Step title="Upload fresh .tickets/ regularly">
    Re-upload your `.tickets/` directory whenever you make significant changes to keep Claude's context current.
  </Step>

  <Step title="Use natural language">
    You don't need to memorize tk commands. Just ask Claude what you want, and it will figure out the right command.
  </Step>

  <Step title="Ask for explanations">
    Claude can interpret tk's graph analytics output and explain what it means for your project.
  </Step>

  <Step title="Combine with MCP">
    For even better results, also install the [tk MCP server](/integrations/mcp) in your local Claude Code setup.
  </Step>
</Steps>

***

## Limitations

<Warning>
  **Read-only by default** — Changes made in Claude Cowork won't sync back to your local repo unless you manually download and merge them.
</Warning>

<Warning>
  **No git integration** — You won't get git history or timestamps in Cowork. For full functionality, use [Claude Code](/integrations/claude-code) locally.
</Warning>

<Info>
  Claude Cowork is best for **quick triage**, **analysis**, and **planning** — not as a replacement for your local tk setup.
</Info>

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="tk command not found">
    Make sure you ran `chmod +x tk` to make the binary executable. Ask Claude: "Make the tk binary executable."
  </Accordion>

  <Accordion title="Wrong architecture error">
    Claude Cowork uses Linux ARM64. Download the correct binary:

    ```
    tk-linux-arm64
    ```
  </Accordion>

  <Accordion title="No .tickets/ directory found">
    Make sure you extracted the `tickets.zip` file. Ask Claude: "Extract tickets.zip."
  </Accordion>

  <Accordion title="Permission denied">
    The binary might not be executable. Run:

    ```bash theme={null}
    chmod +x tk
    ```
  </Accordion>
</AccordionGroup>

***

## Next Steps

<CardGroup cols={2}>
  <Card title="CLI Commands" icon="terminal" href="/cli-reference/commands">
    Full command reference for working with issues
  </Card>

  <Card title="MCP Server" icon="plug" href="/integrations/mcp">
    Give Claude direct access to tk via MCP
  </Card>

  <Card title="Claude Code" icon="code" href="/integrations/claude-code">
    Set up tk locally with Claude Code
  </Card>

  <Card title="Graph Analytics" icon="chart-network" href="/concepts/graph-analytics">
    Learn how tk's AI-powered analytics work
  </Card>
</CardGroup>