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

# Zed

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

Use tk with [Zed](https://zed.dev/) to manage issues from a high-performance, Rust-native code editor with built-in AI and MCP support.

***

## What is Zed?

[Zed](https://zed.dev/) is a high-performance code editor built in Rust with native AI and real-time collaboration features. It supports MCP servers through its Agent Panel, giving AI assistants direct access to external tools. As a Rust-native editor, Zed is a natural fit for the Rust-built tk.

***

## MCP Integration

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

### Configuration

Add to your Zed settings file (`~/.config/zed/settings.json`):

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

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

  **Zed** editor installed from [zed.dev](https://zed.dev/)
</Accordion>

### Verify Installation

1. Open the **Agent Panel** in Zed (sidebar)
2. Go to the Agent Panel **Settings**
3. Look for `ticket-mcp` in the list of context servers
4. A **green dot** indicates the server is active and running

<Tip>
  Zed reads settings on startup. If you edit `settings.json` while Zed is running, restart the editor to pick up changes.
</Tip>

***

## Workflow Tips

### Starting a Session

Ask Zed's AI: *"Run tk triage and show me what I should work on"*

### Creating Issues

Ask Zed's AI: *"Create a bug for the broken syntax highlighting, priority 1"*

Zed's AI will run:

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

### Closing Work

Ask Zed's AI: *"Resolve tk-abc123, the fix is committed"*

### Dependency Management

Ask Zed's AI: *"Show the dependency tree for tk-xyz789"*

### Project Health

Ask Zed's AI: *"Run tk insights and explain the critical path"*

***

## Zed-Specific Features

<AccordionGroup>
  <Accordion title="Rust Community Fit">
    Both Zed and tk are built in Rust. If you're working on Rust projects, tk's instant performance (sub-10ms cached responses) matches Zed's speed-first philosophy.
  </Accordion>

  <Accordion title="Agent Panel Integration">
    Zed's Agent Panel provides a dedicated AI workspace where MCP tools are first-class citizens. The panel shows tool invocations inline with conversation context.
  </Accordion>

  <Accordion title="Multi-Buffer Editing">
    Ask Zed's AI to analyze a tk issue and make changes across multiple files in a single Agent Panel session, with all edits visible as inline diffs.
  </Accordion>
</AccordionGroup>

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="Server not appearing in Agent Panel">
    Verify `context_servers` is at the top level of your `settings.json` (not nested under another key). Restart Zed after editing settings.
  </Accordion>

  <Accordion title="Red status dot on server">
    Hover over the status indicator for error details. Common causes: `uvx` not in PATH, Python version too old, or network issues during first-run package download.
  </Accordion>

  <Accordion title="Tools not available">
    Ensure you're using the Agent Panel (not inline completions). MCP tools are only available through the Agent Panel's AI assistant.
  </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="Zed Docs" icon="book" href="https://zed.dev/docs/ai/mcp">
    Official Zed MCP documentation
  </Card>
</CardGroup>

***

## Sources

* [Zed MCP Documentation](https://zed.dev/docs/ai/mcp)
* [Zed MCP Extensions](https://zed.dev/docs/extensions/mcp-extensions)
* [The Context Outside the Code — Zed Blog](https://zed.dev/blog/mcp)
* [MCP Documentation](https://modelcontextprotocol.io)