/agents command shows 'No agents found' despite valid agent files in .claude/agents/

Description

The /agents slash command shows "No agents found" and offers "Create new agent" despite having 14 valid agent definition files in .claude/agents/.

Environment

• Claude Code version: 2.1.88
• OS: macOS Darwin 25.3.0 (arm64)
• Shell: zsh

Agent file location

.claude/agents/
├── ai-types.md
├── cicd-pipeline.md
├── collector-dev.md
├── docs-architect.md
├── frontend-dev.md
├── github-tracker.md
├── ops-debug.md
├── prompt-engineer.md
├── rule-author.md
├── security-review.md
├── spec-keeper.md
├── test-harness.md
├── test-runner.md
└── type-sync.md

Agent file format (example)

---
name: ops-debug
description: Use when diagnosing runtime failures, scanning errors, AWS API issues...
tools: Read, Edit, Bash, Grep, Glob, WebSearch, mcp__awslabs_aws-documentation-mcp-server__search_documentation, mcp__awslabs_aws-documentation-mcp-server__read_documentation
model: opus
---

# Operations & Debugging Agent

You are debugging specialist...

All 14 files follow the same frontmatter format with name, description, tools, and model fields.

Steps to reproduce

1. Ensure .claude/agents/ contains valid agent .md files with proper frontmatter
2. Start a Claude Code session from the project root
3. Run /agents
4. Dialog shows "No agents found" with only a "Create new agent" option

Expected behavior

The /agents dialog should list all 14 agents discovered from .claude/agents/.

Notes

• The agents can be invoked programmatically via the Agent tool within a session — they work fine when spawned as subagents
• The issue is specifically with the /agents slash command UI not discovering/listing the files nor can they be accessed when typing @....
• Restarting the session did not resolve the issue

Screenshot

The dialog shows:

Agents
No agents found

❯ Create new agent

No agents found. Create specialized subagents that Claude can delegate to.