Files
zed/docs/src/ai/agents.md
T
morgankrey 99739ef047 Restructure AI docs (#57614)
## Summary

- Restructures the AI docs around quick routing, agent paths, provider
access, and company-specific entry points.
- Moves account-owned AI billing/model pages into Account & Billing
while preserving legacy AI redirects.
- Adds focused pages for Zed Agent, external agents, terminal threads,
agent profiles, skills, instructions, API access, subscriptions,
gateways, and local models.
- Updates related links across Git, authentication, business, migration,
and settings reference docs.

## Validation

- `pnpm dlx prettier@3.5.0 . --write`
- `pnpm dlx prettier@3.5.0 . --check`
- `git diff --check -- docs/src`
- Changed-doc local markdown link sanity check
- `mdbook build docs` was attempted; it is currently blocked by an
unrelated existing `docs/src/vim.md:542` action schema error for
`vim::HelixJumpToWord`.

## Follow-up

- Create a ticket to align Zed's in-app AI configuration surfaces with
this documentation model, including Agent Settings, Configure buttons,
Tools, Profiles, MCP, Skills/Instructions, and plain settings.

## Suggested .rules additions

N/A

Release Notes:

- N/A
2026-06-04 15:55:21 +00:00

2.4 KiB

title, description
title description
AI Agents in Zed Compare Zed Agent, External Agents, and Terminal Threads.

Agents

Zed supports three agent paths. Choose the path based on how you want agentic work to run.

Agent path Runs in Uses Best when
Zed Agent Agent Panel and Threads Sidebar Zed-configured LLM providers, native tools, skills, instructions, MCP You want Zed's native agent integration
External Agents Agent Panel and Threads Sidebar ACP agent process and its own auth/config You want Claude, Codex, OpenCode, Copilot, Cursor, Pi, or another ACP-integrated agent
Terminal Threads Threads Sidebar and terminal Native CLI/TUI auth/config You want the tool's command-line experience organized in Zed

An agent path is sometimes called a harness. It is the way agentic work is started, displayed, configured, and controlled in Zed.

Agent Path vs. LLM Provider

Question Start here
Which agent or CLI should run the work? This page
Which model should power Zed AI features? LLM Providers

The Zed Agent uses models configured in Zed. External Agents and Terminal Threads may use their own model setup.

Thread Types

Threads are the units shown in the Threads Sidebar. Thread types include:

Use Parallel Agents to run and manage multiple threads at once.