[BUG] Agents not detected by Native binary installation (MacOS)
Status Fixed / completed
Maintainer reply ✓ Yes — ant-kurt
Workaround ✓ Mentioned in thread ↓
Activity 6 comments · opened Sep 11, 2025 · closed Nov 7, 2025
💡 Likely answer: A maintainer (ant-kurt, collaborator)
responded on this thread — see the highlighted reply below.
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?
When installed from the native binary on MacOS, /agents will report there are no agents found in ~/.claude/agents. When attempting to create one from /agents, the file will be created but /agents will continue to report there are no agents found. Additionally, @agent also does not report custom agents.
What Should Happen?
Agents should be found the same as the npm distribution.
Error Messages/Logs
✅ NPM Installation
<details><summary>Output</summary>
<p>
$ /Users/pdelre/.local/share/fnm/node-versions/v18.20.2/installation/bin/claude
> /doctor
Diagnostics
└ Currently running: unknown (1.0.111)
└ Path: /Users/pdelre/.local/share/fnm/node-versions/v18.20.2/installation/bin/node
└ Invoked: /Users/pdelre/.local/share/fnm/node-versions/v18.20.2/installation/bin/claude
└ Config install method: unknown
└ Auto-updates enabled: default (true)
└ Search: OK (vendor)
Warning: Multiple installations found
└ npm-global at /Users/pdelre/.local/share/fnm/node-versions/v18.20.2/installation/bin/claude
└ native at /Users/pdelre/.local/bin/claude
> /agents
╭─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ Agents │
│ 80 agents │
│ │
│ ❯ Create new agent │
│ │
│ User agents (/Users/pdelre/.claude/agents) │
│ devops-troubleshooter · sonnet │
│ frontend-developer · sonnet │
│ csharp-pro · sonnet │
│ mobile-developer · sonnet
| ....
│ seo-authority-builder · sonnet │
│ sales-automator · haiku │
│ customer-support · sonnet │
│ │
│ Built-in agents (always available) │
│ general-purpose · sonnet │
│ statusline-setup · sonnet │
│ output-style-setup · sonnet │
│ │
╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
Press ↑↓ to navigate · Enter to select · Esc to go back</p>
</details>
❌ Native installation
<details><summary>Output</summary>
<p>
$ /Users/pdelre/.local/bin/claude
> /doctor
Diagnostics
└ Currently running: native (1.0.111)
└ Path: /Users/pdelre/.local/state/fnm_multishells/91089_1756824571303/bin/claude
└ Invoked: /Users/pdelre/.local/share/claude/versions/1.0.111
└ Config install method: native
└ Auto-updates enabled: default (true)
└ Search: OK (bundled)
Warning: Multiple installations found
└ npm-global at /Users/pdelre/.local/share/fnm/node-versions/v18.20.2/installation/bin/claude
└ native at /Users/pdelre/.local/bin/claude
Warning: Leftover npm global installation at /Users/pdelre/.local/share/fnm/node-versions/v18.20.2/installation/bin/claude
Fix: Run: npm -g uninstall @anthropic-ai/claude-code
> /agents
╭─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ Agents │
│ No agents found │
│ │
│ ❯ Create new agent │
│ │
│ No agents found. Create specialized subagents that Claude can delegate to. │
│ Each subagent has its own context window, custom system prompt, and specific tools. │
│ Try creating: Code Reviewer, Code Simplifier, Security Reviewer, Tech Lead, or UX Reviewer. │
│ │
│ │
│ Built-in (always available): │
│ general-purpose · sonnet │
│ statusline-setup · sonnet │
│ output-style-setup · sonnet │
│ │
╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
Press ↑↓ to navigate · Enter to select · Esc to go back</p>
</details>
❌ Homebrew installation
<details><summary>Output</summary>
<p>
$ /opt/homebrew/bin/claude
> /doctor
Diagnostics
└ Currently running: native (1.0.111)
└ Path: /Users/pdelre/.local/state/fnm_multishells/91089_1756824571303/bin/claude
└ Invoked: /opt/homebrew/Caskroom/claude-code/1.0.111/claude
└ Config install method: native
└ Auto-updates enabled: default (true)
└ Search: OK (bundled)
Warning: Multiple installations found
└ npm-global at /Users/pdelre/.local/share/fnm/node-versions/v18.20.2/installation/bin/claude
└ native at /Users/pdelre/.local/bin/claude
Warning: Leftover npm global installation at /Users/pdelre/.local/share/fnm/node-versions/v18.20.2/installation/bin/claude
Fix: Run: npm -g uninstall @anthropic-ai/claude-code
> /agents
╭─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ Agents │
│ No agents found │
│ │
│ ❯ Create new agent │
│ │
│ No agents found. Create specialized subagents that Claude can delegate to. │
│ Each subagent has its own context window, custom system prompt, and specific tools. │
│ Try creating: Code Reviewer, Code Simplifier, Security Reviewer, Tech Lead, or UX Reviewer. │
│ │
│ │
│ Built-in (always available): │
│ general-purpose · sonnet │
│ statusline-setup · sonnet │
│ output-style-setup · sonnet │
│ │
╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
Press ↑↓ to navigate · Enter to select · Esc to go back</p>
</details>
Steps to Reproduce
- Have agents in
~/.claude/agents/ - Install from native instructions or Homebrew
- Native:
curl -fsSL https://claude.ai/install.sh | bash - Homebrew:
brew install claude-code - Start
claude - Run
/agents
Claude Model
None
Is this a regression?
I don't know but it's at least an issue for the past 2 weeks of releases. I wasn't trying to use agents before that.
Last Working Version
I don't know
Claude Code Version
1.0.111
Platform
Anthropic API
Operating System
macOS
Terminal/Shell
Other
Additional Information
_No response_
6 Comments
same issue using wsl. also my custom slash commands are not showing up.
This seems linked to https://github.com/anthropics/claude-code/issues/7429 & https://github.com/anthropics/claude-code/issues/5289.
There are some solutions with setting env var
USE_BUILTIN_RIPGREP=0or modifying one's.ripgreprccolor settings.@ant-kurt (sorry for the ping) FYI, this still seems to be an issue after v1.0.84 (can still reproduce on latest 2.0.9), though there are workarounds.
This should be working better with a few updates:
Removed my workaround of
USE_BUILTIN_RIPGREP=0and confirmed it's working as expected.Thank you!
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.