Back to tips
Remove and Manage Built-in Agents
All built-in agents are now removable via the ACP Registry
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
- Open the Agent Panel
- Click on agent settings or the registry icon
- View all installed agents (including built-in ones)
- Remove unwanted agents with the uninstall button
- 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.