[BUG] Custom Subcommands

Resolved 💬 7 comments Opened Oct 5, 2025 by martinffx Closed Dec 9, 2025

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

  1. 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

  1. Verify the file exists and is readable:

$ ls -la ~/.claude/commands/
.rw------- 1,6k martinrichards 14 Sep 09:29 commit.md

  1. Launch Claude Code v2.0.8
  2. Run /help and navigate to the "custom-commands" tab
  3. Observed: Only MCP tools appear, /commit is missing
  4. 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_

View original on GitHub ↗

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