[FEATURE] enable/disable agents by project

[3src]

Preflight Checklist

• I have searched existing requests and this feature hasn't been requested yet
• This is a single feature request (not multiple features)

Problem Statement

● ★ Insight ─────────────────────────────────────
The Reality of Agent Management in Claude Code

1. No built-in way to disable specific agents - They're all loaded by default
2. Custom agents can be added, but built-ins can't be removed
3. Token overhead is fixed at startup - it's the cost of flexibility
4. Workaround: Environment variables for broader optimization
   ─────────────────────────────────────────────────

🎯 The Truth: No Direct Agent Filtering

I apologize - I gave you incorrect information. After checking the official Claude Code documentation, there is no configuration option to selectively disable built-in Task tool agents. The
agent-config.json file I suggested doesn't exist in Claude Code.

Proposed Solution

/agent-config.json:

{
"disabled_agents": [
"frontend-mobile-development:",
"multi-platform-apps:",
"nextjs-vercel-pro:",
"kubernetes-operations:",
"cloud-infrastructure:kubernetes-architect",
"deployment-strategies:",
"cicd-automation:",
"database-cloud-optimization:",
"database-design:",
"database-migrations:",
"api-scaffolding:",
"payment-processing:",
"blockchain-web3:",
"business-analytics:",
"customer-sales-automation:",
"content-marketing:",
"seo-",
"hr-legal-compliance:",
"llm-application-dev:",
"machine-learning-ops:"
],
"enabled_agents": [
"code-reviewer",
"debugging-toolkit:debugger",
"error-debugging:error-detective",
"Explore",
"general-purpose",
"code-documentation:docs-architect",
"documentation-generation:",
"backend-development:backend-architect",
"shell-scripting:",
"git-workflow:git-flow-manager",
"pr-review-toolkit:",
"performance-optimizer:performance-engineer",
"security-pro:security-auditor"
]
}

Alternative Solutions

No response

Priority

Critical - Blocking my work

Feature Category

CLI commands and flags

Use Case Example

No response

Additional Context

No response

[github-actions]

This issue has been inactive for 30 days. If the issue is still occurring, please comment to let us know. Otherwise, this issue will be automatically closed in 30 days for housekeeping purposes.

[github-actions]

This issue has been automatically closed due to 60 days of inactivity. If you're still experiencing this issue, please open a new issue with updated information.

[github-actions]

This issue has been automatically locked since it was closed and has not had any activity for 7 days. If you're experiencing a similar issue, please file a new issue and reference this one if it's relevant.