yenru0/zed

0 Fork 0

Files

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

6.2 KiB

Raw Blame History

title, description

title	description
AI Quick Start - Zed	Choose the right Zed AI setup path for agents, models, subscriptions, local models, edit prediction, and privacy.

AI Quick Start

Use this page to choose the right AI setup path in Zed. If you already know the company, subscription, model provider, agent, or CLI you want to use, start with AI by Company.

Use the Zed Agent

Use Zed Agent when you want Zed's native agent to read, edit, search, and run code in your project.

Zed Agent uses Zed-configured models from LLM Providers. It also uses Zed's built-in tools, Agent Profiles, Skills, Instructions, and MCP servers.

Start in the Agent Panel to prompt the agent, add context, review changes, and manage threads.

Configure the Zed Agent

If you want to...	Use
Control tools and permissions	Agent Profiles
Approve or deny individual tools	Tool Permissions
Add reusable task instructions	Skills
Add always-on personal or project context	Instructions
Connect external tools and context	Model Context Protocol

Use Another Coding Agent in Zed

Use this path for Claude, Codex, OpenCode, Copilot, Cursor, Pi Coding Agent, Gemini CLI, or another coding agent.

If the agent...	Use
Integrates with Zed through ACP	External Agents
Runs as a CLI or TUI	Terminal Threads

External Agents and Terminal Threads usually own their own auth, model configuration, subscriptions, tools, instructions, and MCP configuration.

Choose Which Models the Zed Agent Uses

The Zed Agent and other model-backed Zed AI features use models configured through LLM Providers.

If you want to...	Use
Use models billed through Zed	Zed-Hosted Models
Bring your own provider API key, credits, top-ups, or usage billing	Use API Access
Use a subscription you already pay for	Use an Existing Subscription
Use OpenRouter, Vercel AI Gateway, Amazon Bedrock, or another gateway	Use a Gateway
Use Ollama, LM Studio, local OpenAI-compatible servers, or self-hosted models	Use a Local Model

Provider keys saved through Zed are stored in the system keychain, not in settings.json.

Change AI Settings

If you want to...	Go to
Configure LLM providers, External Agents, or MCP servers	Agent Settings with {#action agent::OpenSettings}
Disable AI, configure tool permissions, or set up edit prediction providers	Settings Editor with {#action zed::OpenSettings}
Edit advanced JSON-only settings	Settings file with {#action zed::OpenSettingsFile}

For general settings mechanics, see Configuring Zed.

Use a Specific AI Feature

If you want to...	Use
Prompt agents, add context, and review changes	Agent Panel
Accept AI completions while typing	Edit Prediction
Rewrite selected code or terminal text	Inline Assistant
Run multiple AI tasks at once	Parallel Agents
Generate commit messages	Git commit generation

Learn More

If you want to...	Use
Understand privacy and data controls	AI Privacy and Feedback and Training Data
Understand plans, usage, and billing	Plans & Pricing, Zed-Hosted Models, and Billing

Turn AI Off

Open the Settings Editor with {#action zed::OpenSettings}, search for Disable AI, and enable it.

You can also add this to your settings file:

{
  "disable_ai": true
}

When AI is turned off, all AI features are disabled. This includes the Threads Sidebar, Agent Panel, Edit Prediction, and Inline Assistant.

6.2 KiB Raw Blame History