[BUG]

Resolved 💬 5 comments Opened Oct 29, 2025 by drswobodziczka Closed Jan 9, 2026

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

  1. Create centralized workflows directory:

mkdir -p ~/.ai-central/workflows

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

  1. Create symlink in Claude Code commands directory:

mkdir -p ~/.claude/commands
ln -s ~/.ai-central/workflows/test-command.md ~/.claude/commands/test-command.md

  1. Start Claude Code:
  1. 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_

View original on GitHub ↗

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