Back to tips

Remove and Manage Built-in Agents

All built-in agents are now removable via the ACP Registry

ai beginner March 16, 2026 · godruoyi
#agent #acp #registry #customization

All of Zed’s built-in agents (Claude, Codex, Gemini, etc.) have been migrated to the ACP Registry, which means you can now remove agents you don’t use and manage them like any other extension.

What Changed

Previously, built-in agents were hardcoded and always available. Now they’re:

  • Listed in the ACP Registry alongside community agents
  • Removable if you don’t need them
  • Reinstallable from the registry at any time
  • Managed through the same interface as third-party agents

How to Manage Agents

  1. Open the Agent Panel
  2. Click on agent settings or the registry icon
  3. View all installed agents (including built-in ones)
  4. Remove unwanted agents with the uninstall button
  5. Reinstall from the registry if needed later

Why This Matters

Cleaner workspace: Remove agents you never use from the interface.

Reduced clutter: Agent picker only shows relevant options.

User control: Treat built-in agents like any other extension.

Consistent management: One interface for all agents regardless of source.

Example Use Cases

  • Remove Gemini if you only use Claude
  • Uninstall Codex if you prefer other models
  • Simplify the agent picker to just your preferred agents
  • Reinstall agents when your workflow changes

This change gives you complete control over your agent setup, letting you tailor Zed’s AI features to your specific needs and preferences.