[BUG]
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 stored in ~/.claude/commands/*.md as symlinked files are not being discovered or loaded by Claude Code 2.0.28.
Commands do not appear in autocomplete or the custom-commands tab, for both: terminal or IDE extension.
It's BREAKING change -- I can no longer reuse easily my global commands and maintain them in convenient way. It worked for previous versions (it worked couple of days ago).
Please support and fix!
What Should Happen?
Claude Code should follow symlinked files when discovering slash commands, similar to how standard Unix tools (cat, ls, head, etc.) handle symlinks transparently.
Expected behavior:
Symlinked .md files in ~/.claude/commands/ should be discovered on Claude Code startup
Commands should appear in /help and autocomplete
Commands should be executable when invoked
Error Messages/Logs
No error messages appear. Commands simply don't exist in the UI.
Steps to Reproduce
- Create centralized workflows directory:
mkdir -p ~/.ai-central/workflows
- Create a test workflow file:
cat > ~/.ai-central/workflows/test-command.md << 'EOF'
---
description: Test command for symlink detection
---
# Test Command
This is a test command to verify symlink support.
Arguments: $ARGUMENTS
EOF
- Create symlink in Claude Code commands directory:
mkdir -p ~/.claude/commands
ln -s ~/.ai-central/workflows/test-command.md ~/.claude/commands/test-command.md
- Start Claude Code:
- Check for custom commands:
/help
Expected: /test-command appears in the list
Actual: Only built-in commands and MCP tools appear
Claude Model
Sonnet (default)
Is this a regression?
Yes, this worked in a previous version
Last Working Version
_No response_
Claude Code Version
2.0.28
Platform
Anthropic API
Operating System
macOS
Terminal/Shell
Warp
Additional Information
_No response_
This issue has 5 comments on GitHub. Read the full discussion on GitHub ↗