Feature: Make agent search paths configurable
Status Open
Maintainer reply None cached
Workaround ✓ Mentioned in description ↑
Activity 0 comments · opened Jul 31, 2026
Description
Currently, Claude Code only searches for agents in two hardcoded locations:
.claude/agents/(project level)~/.claude/agents/(user level)
It would be helpful to allow custom agent search paths via settings configuration.
Use Case
Teams may want to organize agents in different locations, such as:
.github/agents/(alongside GitHub workflows)tools/agents/(in a tools directory)- Other project-specific locations
Proposed Solution
Add a configurable setting (e.g., agentSearchPaths in .claude/settings.json) that allows specifying additional directories to search for agents.
Example:
{
"agentSearchPaths": [
".github/agents",
"tools/agents"
]
}
This would be merged with the default search paths rather than replacing them.
Alternatives Considered
- Symlinks (workaround, but not ideal for teams)
- Moving agents to fixed locations (limits flexibility)