[BUG] User Agents Incorrectly Marked as "Overridden by projectSettings"

Resolved 💬 16 comments Opened Oct 20, 2025 by pnunezcalzado Closed Jan 12, 2026

Preflight Checklist

  • [x] I have searched existing issues and this hasn't been reported yet
  • [x] This is a single bug report (please file separate reports for different bugs)
  • [x] I am using the latest version of Claude Code

What's Wrong?

Description

When running /agents, user-level agents are incorrectly displayed with a warning indicator ⚠ overridden by projectSettings, even though the project has no agent configuration.

Actual Behavior

User agents display with the ⚠ overridden by projectSettings warning, suggesting there's a project-level override when none exists.

Environment

  • The project's .claude/settings.json contains:

``json
{
"permissions": {
"deny": [
"Read(./.idea/**)",
"Read(./dist/**)",
...
]
}
}
``

  • No agent configuration exists in the project
  • User-level agents are present in ~/.claude/agents/

Output Example

User agents (/Users/.../.claude/agents)
  code-review · sonnet ⚠ overridden by projectSettings
  code-auditor · sonnet ⚠ overridden by projectSettings
  backend-ts · sonnet ⚠ overridden by projectSettings

Project agents (/Users/.../.claude/agents)
  code-review · sonnet
  code-auditor · sonnet
  backend-ts · sonnet

What Should Happen?

User agents should not show the "overridden by projectSettings" warning when the project settings do not contain any agent configuration.

Error Messages/Logs

Steps to Reproduce

  1. Create a project with a .claude/settings.json that contains only permissions (no agent configuration)
  2. Have user-level agents defined in ~/.claude/agents/
  3. Run /agents command in the project

Claude Model

Other

Is this a regression?

Yes, this worked in a previous version

Last Working Version

_No response_

Claude Code Version

2.0.24 (Claude Code)

Platform

Anthropic API

Operating System

macOS

Terminal/Shell

Other

Additional Information

Model: Haiku
Terminal/Shell: WebStorm terminal

View original on GitHub ↗

16 Comments

sysuClaude · 8 months ago

I'm having the same issue. Is there a solution available?

lucas-thimoteo-sy · 8 months ago

I am facing the same issue in my computer:

<img width="864" height="480" alt="Image" src="https://github.com/user-attachments/assets/6c9e35dc-2dd3-4dcd-a742-d4643e6ae498" />

In my case, I also noticed that starting claude from within a project folder makes this problem even worse, the agents appear 3 times: twice caused by the user level agents being duplicated into project level agents, then one more time because of the project level agents. In my case, they are the same, but I would expect a full override instead of duplication. See the image below:

<img width="864" height="430" alt="Image" src="https://github.com/user-attachments/assets/80ecbbf8-fc95-42f7-a092-3fbe0d5adfa9" />

pourtorabehsan · 8 months ago

Having the same issue, and it says the agent is not available.

<img width="560" height="413" alt="Image" src="https://github.com/user-attachments/assets/08de2162-1208-491b-b370-a0fa6c133602" />

AndyMik90 · 8 months ago

same

alexandru-wd · 8 months ago

Same, and my local agents are not even shown, even though they exist.

ralfkrakowski · 8 months ago

Same problem here

kyletravis · 8 months ago

same issue as reported.

MaximusBenjamin · 8 months ago

Same issue here

macCesar · 8 months ago

Same issue here!!

HimashaHerath · 8 months ago

any solution yet ?

Masaicker · 8 months ago

same problem here

aliceric27 · 8 months ago

same problem here

Bairum · 8 months ago

Same here.

github-actions[bot] · 7 months ago

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[bot] · 6 months ago

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[bot] · 5 months ago

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.