feat(tools): add Zed Agent support

[clay-good]

Risk: low. One new entry in the supported-tools table. Purely additive — no existing tool's behavior changes.

What was wrong

openspec init --tools zed was rejected, even though Zed's built-in Agent reads project skills from .agents/skills, which OpenSpec already generates.

What changes

Adds zed as a skills-only target that reuses the existing .agents/skills generation and ownership marker. Detection uses the standard .zed project directory.

Why it's safe

No new generation path — it opts into the one that already exists. Adding Zed to a project that already uses Codex preserves Codex's dual-syntax tree; the shared-root ownership marker is unchanged.

Proof

Before: Invalid tool(s): zed. After: init succeeds and openspec update rediscovers it. 412 focused shared-root, update and CLI tests pass. CI green on all three platforms. Verified on this release stack that init --tools zed writes 6 skills under .agents/skills.

Closes #202

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: bc6d2821-27e7-41c8-b1cd-a30f5e3f8cd8

📥 Commits

Reviewing files that changed from the base of the PR and between 459acb3 and 384a6f0.

📒 Files selected for processing (4)

• docs/supported-tools.md
• src/core/config.ts
• test/cli-e2e/basic.test.ts
• test/core/available-tools.test.ts

🚧 Files skipped from review as they are similar to previous changes (3)

• src/core/config.ts
• docs/supported-tools.md
• test/cli-e2e/basic.test.ts

---

📝 Walkthrough

Walkthrough

Added Zed Agent as a skills-only tool using the shared .agents/skills tree. Updated target reconciliation, detection, initialization and update tests, user documentation, and the windsurf CLI alias documentation.

Changes

Zed Agent support

Layer / File(s)	Summary
Register Zed Agent and document shared skills src/core/config.ts, docs/supported-tools.md, docs/how-commands-work.md, docs/troubleshooting.md	Registered zed with .agents/skills. Documented Zed Agent invocation, shared-tree ownership, supported IDs, and limitations.
Reconcile shared skill targets src/core/init.ts, test/core/init.test.ts, test/cli-e2e/basic.test.ts	Updated shared-target selection for Codex, Zed, and generic agents. Tests cover ownership preservation, target markers, generated skills, and update behavior.
Detect Zed Agent configurations test/core/available-tools.test.ts	Added coverage for .zed detection and shared-target marker handling.

CLI tool documentation

Layer / File(s)	Summary
Document the Windsurf alias docs/cli.md, docs/commands.md	Documented windsurf as an alias for devin. The command syntax entry remains unchanged.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Merge Risk: ⚪ Minimal · up to 384a6

This PR adds built-in Zed Agent skills support while preserving existing Codex behavior and documents the shared-root setup. Targeted tests, build, and lint pass, so no actionable merge-blocking risk remains beyond normal checks.

Sequence Diagram(s)

sequenceDiagram
  participant User
  participant InitCLI as openspec init
  participant ValidateTools as validateTools
  participant SharedSkills as .agents/skills
  User->>InitCLI: select zed, Codex, or agents
  InitCLI->>ValidateTools: reconcile shared target
  ValidateTools->>SharedSkills: write skills and target marker
  SharedSkills-->>User: provide Zed-compatible skills

Loading

Possibly related PRs

• Fission-AI/OpenSpec#1303: Added the shared .agents/skills integration extended by this change.
• Fission-AI/OpenSpec#1511: Updated shared .agents/skills ownership and reconciliation.
• Fission-AI/OpenSpec#1522: Modified shared-target ownership and preservation across tools.

Suggested reviewers: tabishb, alfred-openspec

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Out of Scope Changes check	⚠️ Warning	The PR includes an unrelated Windsurf alias documentation change and a no-op docs/commands edit outside Zed support.	Remove the unrelated Windsurf and no-op command documentation edits, or link them to a separate issue.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Linked Issues check	✅ Passed	The PR implements built-in Zed Agent support through .agents/skills, directly addressing the request in issue #202.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly and concisely identifies the main change: adding support for Zed Agent tools.

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch codex/add-zed-support

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[cloudflare-workers-and-pages]

Deploying openspec-docs with    Cloudflare Pages

Latest commit:	0fea1c0
Status:	✅  Deploy successful!
Preview URL:	https://35788436.openspec-docs.pages.dev
Branch Preview URL:	https://codex-add-zed-support.openspec-docs.pages.dev

View logs

[clay-good]

Scope-check clarification: the Windsurf alias text is unchanged from origin/main; the only change on that line is adding the new zed tool ID. The docs/commands.md row likewise changes only by adding Zed Agent to the skills-only tools. Both hunks are required Zed documentation, so there is no unrelated Windsurf or no-op change to remove.