Custom agents not appearing in /agents interface despite being properly configured

Resolved 💬 13 comments Opened Aug 5, 2025 by klauern Closed Aug 20, 2025

Environment

  • Platform (select one):
  • [x] AWS Bedrock
  • Claude CLI version: 1.0.69 (Claude Code)
  • Operating System: macOS Darwin 24.5.0
  • Terminal: Terminal.app

Bug Description

Custom agents are properly configured in ~/.claude/agents/ directory but are not appearing in the /agents slash command interface. The interface shows "No agents found" despite having 3 valid agent configuration files with proper YAML frontmatter.

Steps to Reproduce

  1. Create custom agent files in ~/.claude/agents/ directory (e.g., git-worktree-creator.md, merge-conflict-resolver.md, pr-creator.md)
  2. Ensure files have proper YAML frontmatter with name, description, and model fields
  3. Run /agents command in Claude Code
  4. Observe the agents interface

Expected Behavior

The /agents command should display all 3 configured custom agents in the interface, allowing them to be selected and used.

Actual Behavior

Interface displays "No agents found" and only shows the built-in general-purpose agent. Custom agents are completely missing from the UI despite being present and properly formatted.

Additional Context

  • All agent files are properly formatted with valid YAML frontmatter
  • No errors appear in logs (~/Library/Logs/Claude/main.log)
  • Files have correct permissions and are readable
  • Agent discovery mechanism appears to be failing silently
  • Example agent config structure:

\\\yaml
---
name: git-worktree-creator
description: "Use this agent when you need to create a new git worktree..."
model: us.anthropic.claude-3-5-haiku-20241022-v1:0
---
\
\\

View original on GitHub ↗

This issue has 13 comments on GitHub. Read the full discussion on GitHub ↗