[BUG] Custom Subcommands
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?
Custom slash commands in ~/.claude/commands/ are not being discovered or displayed in
Claude Code v2.0.8. The /help command only shows MCP tools under the custom-commands tab,
but none of my user-defined commands appear.
I have 11 custom commands (3 top-level + 8 namespaced) that exist with proper formatting and
permissions, but Claude Code doesn't recognize them.
What Should Happen?
The /help custom-commands tab should display all custom commands from
~/.claude/commands/:
- Top-level:
/commit,/review,/validate - Namespaced:
/product:init,/product:progress,/product:roadmap,/spec:create,
/spec:design, /spec:implement, /spec:plan, /spec:progress
These commands should be executable when typed.
Error Messages/Logs
No error messages. Commands simply don't appear in `/help` or get recognized when typed.
Steps to Reproduce
- Create command files in
~/.claude/commands/with this structure:
```bash
mkdir -p ~/.claude/commands
cat > ~/.claude/commands/commit.md << 'EOF'
---
description: Analyze changes and create a well-crafted git commit
allowed-tools: Bash(git add:), Bash(git status:)
---
Analyze the current git status and create an appropriate commit message.
EOF
- Verify the file exists and is readable:
$ ls -la ~/.claude/commands/
.rw------- 1,6k martinrichards 14 Sep 09:29 commit.md
- Launch Claude Code v2.0.8
- Run /help and navigate to the "custom-commands" tab
- Observed: Only MCP tools appear, /commit is missing
- Expected: /commit should appear with its description
Environment:
- Claude Code version: v2.0.8
- Platform: macOS (Darwin 24.6.0)
- Commands worked in previous versions (possible regression)
Additional context: Command file format follows the documentation at
https://docs.claude.com/en/docs/claude-code/slash-commands.md
Claude Model
None
Is this a regression?
Yes, this worked in a previous version
Last Working Version
_No response_
Claude Code Version
2.0.8
Platform
Anthropic API
Operating System
macOS
Terminal/Shell
Other
Additional Information
_No response_
This issue has 7 comments on GitHub. Read the full discussion on GitHub ↗