Feature: Make agent search paths configurable

Status Open
Maintainer reply None cached
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)

View original on GitHub ↗