Fixes for AI docs by macraig · Pull Request #58969 · zed-industries/zed

macraig · 2026-06-09T21:00:54Z

Audited the AI documentation against the implementation

Changes

tool-permissions: skill tool patterns match the absolute SKILL.md path, not the skill name (fixed the table, example pattern, and added a clarifying note).
external-agents: Gemini CLI receives Zed's Google AI key when no env key is set; extension-provided agents are deprecated in favor of the ACP registry.
inline-assistant: alternatives run alongside the inline assistant model (not just the default model); fixed a broken anchor and gpt-4-mini → gpt-5-mini model id typos.
mcp: corrected the extensions menu item name ("Install New Servers…"), the remote server url example, and removed the nonexistent thinking tool from the profile example.
agent-panel: "New From Summary" lives in the New Thread menu; corrected the @-mention type list (no "instruction files"; added Fetch and Branch Diff).
use-api-access: DeepSeek default api_url includes /v1.
skills: folder name is a convention not a requirement; long descriptions warn rather than fail (measured in bytes); hidden skills are also @-mentionable; dropped the unenforced consecutive-hyphen rule; reconciled the no-remote-registry note with GitHub import.
edit-prediction: alt-tab and alt-l are bound across platforms; predictions are throttled rather than fired on every keystroke.
getting-started, windows-and-projects, parallel-agents: Panel Layout lives in the title-bar user menu, with workspace::UseAgenticLayout/UseClassicLayout action references.

Release Notes:

N/A

Correct several factual errors in the AI docs found by auditing against the implementation: - tool-permissions: skill tool patterns match the absolute SKILL.md path, not the skill name - external-agents: Gemini CLI receives Zed's Google AI key; extension agents are deprecated in favor of the ACP registry - inline-assistant: alternatives run alongside the inline assistant model (not just the default model); fix broken anchor and model id typos - mcp: correct the extensions menu item name, the remote server url example, and drop the nonexistent thinking tool - agent-panel: New From Summary lives in the New Thread menu; fix the mention type list - use-api-access: DeepSeek default api_url includes /v1 - skills: folder name is a convention not a requirement; long descriptions warn rather than fail; hidden skills are also @-mentionable; drop the unenforced consecutive-hyphen rule; reconcile the no-remote-registry note with GitHub import - edit-prediction: alt-tab/alt-l are bound on all platforms; predictions are throttled rather than per-keystroke - getting-started, windows-and-projects, parallel-agents: Panel Layout is in the title-bar user menu

probably-neb · 2026-06-11T15:18:23Z

@zed-zippy approve

macraig · 2026-06-12T15:51:59Z

/cherry-pick stable

zed-zippy · 2026-06-12T15:52:40Z

🍒💥 Cherry-pick did not succeed
https://github.com/zed-industries/zed/actions/runs/27426851745

macraig · 2026-06-12T16:05:32Z

/cherry-pick preview

Cherry-pick of #58969 to preview ---- Audited the AI documentation against the implementation ## Changes - **tool-permissions**: `skill` tool patterns match the absolute `SKILL.md` path, not the skill name (fixed the table, example pattern, and added a clarifying note). - **external-agents**: Gemini CLI receives Zed's Google AI key when no env key is set; extension-provided agents are deprecated in favor of the ACP registry. - **inline-assistant**: alternatives run alongside the inline assistant model (not just the default model); fixed a broken anchor and `gpt-4-mini` → `gpt-5-mini` model id typos. - **mcp**: corrected the extensions menu item name ("Install New Servers…"), the remote server `url` example, and removed the nonexistent `thinking` tool from the profile example. - **agent-panel**: "New From Summary" lives in the New Thread menu; corrected the `@`-mention type list (no "instruction files"; added Fetch and Branch Diff). - **use-api-access**: DeepSeek default `api_url` includes `/v1`. - **skills**: folder name is a convention not a requirement; long descriptions warn rather than fail (measured in bytes); hidden skills are also `@`-mentionable; dropped the unenforced consecutive-hyphen rule; reconciled the no-remote-registry note with GitHub import. - **edit-prediction**: `alt-tab` and `alt-l` are bound across platforms; predictions are throttled rather than fired on every keystroke. - **getting-started, windows-and-projects, parallel-agents**: Panel Layout lives in the title-bar user menu, with `workspace::UseAgenticLayout`/`UseClassicLayout` action references. Release Notes: - N/A --------- Co-authored-by: zed-zippy[bot] <234243425+zed-zippy[bot]@users.noreply.github.com> Co-authored-by: María Craig <maria@zed.dev> Co-authored-by: zed-zippy[bot] <234243425+zed-zippy[bot]@users.noreply.github.com>

Audited the AI documentation against the implementation ## Changes - **tool-permissions**: `skill` tool patterns match the absolute `SKILL.md` path, not the skill name (fixed the table, example pattern, and added a clarifying note). - **external-agents**: Gemini CLI receives Zed's Google AI key when no env key is set; extension-provided agents are deprecated in favor of the ACP registry. - **inline-assistant**: alternatives run alongside the inline assistant model (not just the default model); fixed a broken anchor and `gpt-4-mini` → `gpt-5-mini` model id typos. - **mcp**: corrected the extensions menu item name ("Install New Servers…"), the remote server `url` example, and removed the nonexistent `thinking` tool from the profile example. - **agent-panel**: "New From Summary" lives in the New Thread menu; corrected the `@`-mention type list (no "instruction files"; added Fetch and Branch Diff). - **use-api-access**: DeepSeek default `api_url` includes `/v1`. - **skills**: folder name is a convention not a requirement; long descriptions warn rather than fail (measured in bytes); hidden skills are also `@`-mentionable; dropped the unenforced consecutive-hyphen rule; reconciled the no-remote-registry note with GitHub import. - **edit-prediction**: `alt-tab` and `alt-l` are bound across platforms; predictions are throttled rather than fired on every keystroke. - **getting-started, windows-and-projects, parallel-agents**: Panel Layout lives in the title-bar user menu, with `workspace::UseAgenticLayout`/`UseClassicLayout` action references. Release Notes: - N/A --------- Co-authored-by: zed-zippy[bot] <234243425+zed-zippy[bot]@users.noreply.github.com>

…d-industries#59203) Cherry-pick of zed-industries#58969 to preview ---- Audited the AI documentation against the implementation ## Changes - **tool-permissions**: `skill` tool patterns match the absolute `SKILL.md` path, not the skill name (fixed the table, example pattern, and added a clarifying note). - **external-agents**: Gemini CLI receives Zed's Google AI key when no env key is set; extension-provided agents are deprecated in favor of the ACP registry. - **inline-assistant**: alternatives run alongside the inline assistant model (not just the default model); fixed a broken anchor and `gpt-4-mini` → `gpt-5-mini` model id typos. - **mcp**: corrected the extensions menu item name ("Install New Servers…"), the remote server `url` example, and removed the nonexistent `thinking` tool from the profile example. - **agent-panel**: "New From Summary" lives in the New Thread menu; corrected the `@`-mention type list (no "instruction files"; added Fetch and Branch Diff). - **use-api-access**: DeepSeek default `api_url` includes `/v1`. - **skills**: folder name is a convention not a requirement; long descriptions warn rather than fail (measured in bytes); hidden skills are also `@`-mentionable; dropped the unenforced consecutive-hyphen rule; reconciled the no-remote-registry note with GitHub import. - **edit-prediction**: `alt-tab` and `alt-l` are bound across platforms; predictions are throttled rather than fired on every keystroke. - **getting-started, windows-and-projects, parallel-agents**: Panel Layout lives in the title-bar user menu, with `workspace::UseAgenticLayout`/`UseClassicLayout` action references. Release Notes: - N/A --------- Co-authored-by: zed-zippy[bot] <234243425+zed-zippy[bot]@users.noreply.github.com> Co-authored-by: María Craig <maria@zed.dev> Co-authored-by: zed-zippy[bot] <234243425+zed-zippy[bot]@users.noreply.github.com>

Audited the AI documentation against the implementation ## Changes - **tool-permissions**: `skill` tool patterns match the absolute `SKILL.md` path, not the skill name (fixed the table, example pattern, and added a clarifying note). - **external-agents**: Gemini CLI receives Zed's Google AI key when no env key is set; extension-provided agents are deprecated in favor of the ACP registry. - **inline-assistant**: alternatives run alongside the inline assistant model (not just the default model); fixed a broken anchor and `gpt-4-mini` → `gpt-5-mini` model id typos. - **mcp**: corrected the extensions menu item name ("Install New Servers…"), the remote server `url` example, and removed the nonexistent `thinking` tool from the profile example. - **agent-panel**: "New From Summary" lives in the New Thread menu; corrected the `@`-mention type list (no "instruction files"; added Fetch and Branch Diff). - **use-api-access**: DeepSeek default `api_url` includes `/v1`. - **skills**: folder name is a convention not a requirement; long descriptions warn rather than fail (measured in bytes); hidden skills are also `@`-mentionable; dropped the unenforced consecutive-hyphen rule; reconciled the no-remote-registry note with GitHub import. - **edit-prediction**: `alt-tab` and `alt-l` are bound across platforms; predictions are throttled rather than fired on every keystroke. - **getting-started, windows-and-projects, parallel-agents**: Panel Layout lives in the title-bar user menu, with `workspace::UseAgenticLayout`/`UseClassicLayout` action references. Release Notes: - N/A --------- Co-authored-by: zed-zippy[bot] <234243425+zed-zippy[bot]@users.noreply.github.com>

cla-bot Bot added the cla-signed The user has signed the Contributor License Agreement label Jun 9, 2026

zed-community-bot Bot added the staff Pull requests authored by a current member of Zed staff label Jun 9, 2026

macraig changed the title ~~Fix inaccurate claims in AI documentation~~ Fixes for AI docs Jun 9, 2026

macraig commented Jun 9, 2026

View reviewed changes

Comment thread docs/src/ai/edit-prediction.md

macraig commented Jun 9, 2026

View reviewed changes

Comment thread docs/src/ai/edit-prediction.md

macraig commented Jun 9, 2026

View reviewed changes

Comment thread docs/src/ai/external-agents.md

macraig and others added 2 commits June 11, 2026 10:20

Autofix

63c82ad

macraig force-pushed the ai-docs-audit branch from cb8e6b6 to 63c82ad Compare June 11, 2026 13:22

macraig added this pull request to the merge queue Jun 11, 2026

Merged via the queue into main with commit cfc5f26 Jun 11, 2026
32 checks passed

macraig deleted the ai-docs-audit branch June 11, 2026 15:20

zed-zippy Bot mentioned this pull request Jun 12, 2026

Fixes for AI docs (#58969) (cherry-pick to preview) #59203

Merged

github-actions Bot mentioned this pull request Jun 17, 2026

Review upstream Zed v1.7.2 neozed-industries/neo-zed#45

Open

This was referenced Jun 18, 2026

fix/commit author #59516

Closed

fix/linked images clickable #59518

Closed

github-actions Bot mentioned this pull request Jun 24, 2026

Review upstream Zed v1.8.2 neozed-industries/neo-zed#46

Open

This was referenced Jul 1, 2026

Review upstream Zed v1.9.0 neozed-industries/neo-zed#47

Open

Review upstream Zed v1.10.0 neozed-industries/neo-zed#48

Open

This was referenced Jul 10, 2026

Review upstream Zed v1.10.2 neozed-industries/neo-zed#49

Open

Review upstream Zed v1.10.3 neozed-industries/neo-zed#50

Open

Navigation Menu

Uh oh!

Uh oh!

Fixes for AI docs - #58969

Fixes for AI docs#58969
macraig merged 2 commits into
mainfrom
ai-docs-audit

macraig commented Jun 9, 2026 •

edited

Loading

Uh oh!

Uh oh!

Uh oh!

Uh oh!

probably-neb commented Jun 11, 2026

Uh oh!

Uh oh!

macraig commented Jun 12, 2026

Uh oh!

zed-zippy Bot commented Jun 12, 2026

Uh oh!

macraig commented Jun 12, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Uh oh!

Uh oh!

Conversation

macraig commented Jun 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

probably-neb commented Jun 11, 2026

Uh oh!

Uh oh!

macraig commented Jun 12, 2026

Uh oh!

zed-zippy Bot commented Jun 12, 2026

Uh oh!

macraig commented Jun 12, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

macraig commented Jun 9, 2026 •

edited

Loading