Files
zed/docs/src/ai/zed-agent.md
T
morgankrey 3d700c5042 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.3 KiB

title, description
title description
Zed Agent Use Zed's native AI agent with Zed-configured models, tools, profiles, skills, instructions, and MCP servers.

Zed Agent

Zed Agent is Zed's native agent path. It runs in the Agent Panel and Threads Sidebar, uses models configured through LLM Providers, and integrates with Zed's project, editor, terminal, and review surfaces.

Use Zed Agent when you want the agent to:

  • read and search your project
  • edit files
  • run terminal commands
  • use Zed-managed MCP tools
  • follow Agent Profiles
  • use Zed Skills and Instructions
  • show changes in Zed's review UI

What Zed Agent Uses

Capability Source of truth
Model access LLM Providers
Panel workflow Agent Panel
Tool availability Agent Profiles
Tool approval behavior Tool Permissions
Built-in tools Tools
External tools MCP
Reusable task instructions Skills
Always-on instructions Instructions

How It Differs from Other Agent Paths

Agent path Main difference
Zed Agent Uses Zed's model, tool, profile, skill, instruction, and MCP configuration
External Agents Use an ACP integration and often own auth, model, tool, and native instruction configuration
Terminal Threads Run a CLI/TUI in a terminal-backed thread; the CLI owns auth and configuration

See Agents for the full comparison.