> ## 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 Chat (Web/Desktop)

> Use tk with Claude's web chat interface for AI-powered issue tracking

Use **tk** with [Claude's web chat](https://claude.ai) to analyze your project's issues, dependencies, and priorities directly in the browser — no local setup required.

***

## What is Claude Chat?

**Claude Chat** is the standard web interface at [claude.ai](https://claude.ai). With the **Artifacts** feature, you can:

* ✅ Upload files and binaries
* ✅ Run commands in a sandboxed environment
* ✅ Get instant AI analysis
* ✅ No installation required

This makes it perfect for quick triage sessions or when you're away from your development machine.

***

## Why Use tk with Claude Chat?

<CardGroup cols={2}>
  <Card title="Zero Setup" icon="bolt">
    Upload the binary and start using tk immediately — no installation, no configuration
  </Card>

  <Card title="Quick Analysis" icon="magnifying-glass-chart">
    Get instant AI-powered recommendations on what to work on next
  </Card>

  <Card title="On-the-Go Access" icon="mobile">
    Access your issues from any device with a web browser
  </Card>

  <Card title="Natural Language" icon="message">
    Just ask Claude what you want — it knows how to run tk commands
  </Card>
</CardGroup>

***

## Setup Instructions

### Step 1: Download the tk Binary

Download the **Linux x86\_64** binary (Claude Chat runs on x86\_64 architecture):

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

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

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

<Tip>
  Claude Chat uses **Linux x86\_64**. Make sure you download the correct architecture.
</Tip>

***

### Step 2: Upload Files to Claude

1. Go to [claude.ai](https://claude.ai) and start a new conversation
2. Click the **paperclip icon** to attach files

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

1. Upload both:
   * The `tk` binary you downloaded
   * Your `.tickets/` directory (you can drag and drop the folder)

<img src="https://mintcdn.com/stardust-d1398d07/51CM4tqVBKzhxqZY/images/claude/chat/upload-tk.png?fit=max&auto=format&n=51CM4tqVBKzhxqZY&q=85&s=63fce30c93a43327bb8440b29610f988" alt="Upload tk binary and tickets directory" width="1290" height="1330" data-path="images/claude/chat/upload-tk.png" />

***

### Step 3: Ask Claude to Set Up tk

Simply ask Claude to make the binary executable and verify it works:

```
Make the tk binary executable and run tk --help
```

Claude will automatically run:

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

<img src="https://mintcdn.com/stardust-d1398d07/51CM4tqVBKzhxqZY/images/claude/chat/run-tk.png?fit=max&auto=format&n=51CM4tqVBKzhxqZY&q=85&s=871061452c9dd63c8fe3c7d17a90d582" alt="Claude makes tk executable and runs it" width="1534" height="1782" data-path="images/claude/chat/run-tk.png" />

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

***

## Usage Examples

Now you can interact with tk naturally through Claude:

<AccordionGroup>
  <Accordion title="Get instant triage recommendations">
    **You:** "What should I work on? Run tk triage and explain the recommendations."

    **Claude:** Runs `./tk triage` and analyzes the output, explaining:

    * Which issues have the highest impact
    * What's blocking the most work
    * Quick wins you can knock out
    * Overall project health
  </Accordion>

  <Accordion title="Analyze dependencies">
    **You:** "Show me the dependency tree for tk-abc123 and explain what's blocking it."

    **Claude:** Runs `./tk dep tree tk-abc123` and explains the dependency chain, identifying blockers.
  </Accordion>

  <Accordion title="Find ready work">
    **You:** "What issues can I start working on right now?"

    **Claude:** Runs `./tk ready --limit 10` and shows you all unblocked issues, optionally filtering by priority.
  </Accordion>

  <Accordion title="Create new issues">
    **You:** "Create a high-priority feature issue for adding OAuth authentication"

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

  <Accordion title="Get project insights">
    **You:** "What are the biggest bottlenecks in this project?"

    **Claude:** Runs `./tk insights` and explains:

    * High centrality issues (bottlenecks)
    * Critical path analysis
    * PageRank priorities
  </Accordion>
</AccordionGroup>

***

## Best Practices

<Steps>
  <Step title="Upload fresh .tickets/ regularly">
    For the most accurate analysis, re-upload your `.tickets/` directory whenever you make significant changes.
  </Step>

  <Step title="Ask follow-up questions">
    Claude can explain tk's analytics output in plain English. Don't hesitate to ask "Why is this issue important?"
  </Step>

  <Step title="Use for planning sessions">
    Great for sprint planning, roadmap discussions, and project health check-ins.
  </Step>

  <Step title="Combine with local workflow">
    Use Claude Chat for analysis, then switch to [Claude Code](/integrations/claude-code) for implementation.
  </Step>
</Steps>

***

## Comparison: Chat vs. Cowork vs. Code

<table>
  <thead>
    <tr>
      <th>Feature</th>
      <th>Claude Chat</th>
      <th>Claude Cowork</th>
      <th>Claude Code</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>**Architecture**</td>
      <td>Linux x86\_64</td>
      <td>Linux ARM64</td>
      <td>Local machine</td>
    </tr>

    <tr>
      <td>**File Upload**</td>
      <td>Drag & drop</td>
      <td>File picker</td>
      <td>Direct access</td>
    </tr>

    <tr>
      <td>**Best For**</td>
      <td>Quick analysis</td>
      <td>Research preview</td>
      <td>Full workflow</td>
    </tr>

    <tr>
      <td>**Git Integration**</td>
      <td>No</td>
      <td>No</td>
      <td>Yes</td>
    </tr>

    <tr>
      <td>**Persistent Session**</td>
      <td>Conversation-based</td>
      <td>Session-based</td>
      <td>Always available</td>
    </tr>
  </tbody>
</table>

***

## Limitations

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

<Warning>
  **Session-based** — When you start a new conversation, you'll need to re-upload the binary and tickets.
</Warning>

<Info>
  Claude Chat is best for **quick triage**, **one-off analysis**, and **planning** — not as a replacement for your local tk workflow.
</Info>

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="tk command not found">
    Make sure you uploaded the binary and asked Claude to run `chmod +x tk`. Try: "Make the tk binary executable."
  </Accordion>

  <Accordion title="Wrong architecture error">
    Claude Chat uses Linux x86\_64. Download the correct binary:

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

  <Accordion title="No .tickets/ directory found">
    Make sure you uploaded your `.tickets/` folder. You can drag and drop the entire directory into the chat.
  </Accordion>

  <Accordion title="Permission denied">
    The binary needs execute permissions. Ask Claude: "Run chmod +x tk"
  </Accordion>
</AccordionGroup>

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Claude Code" icon="code" href="/integrations/claude-code">
    Set up tk locally with Claude Code for full workflow integration
  </Card>

  <Card title="Claude Cowork" icon="users" href="/integrations/claude-cowork">
    Try the research preview with persistent sessions
  </Card>

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

  <Card title="CLI Commands" icon="terminal" href="/cli-reference/commands">
    Learn all the tk commands Claude can run for you
  </Card>
</CardGroup>