claude-code - 💡(How to fix) Fix Global commands from ~/.claude/commands/ not appearing in slash command menu [1 comments, 2 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
anthropics/claude-code#48820Fetched 2026-04-16 06:50:02
View on GitHub
Comments
1
Participants
2
Timeline
7
Reactions
1
Timeline (top)
labeled ×4commented ×1cross-referenced ×1subscribed ×1

Custom global commands in ~/.claude/commands/ are not appearing in the slash command menu (either via / filter or the + → "Slash commands" UI). Only two plugin-provided skills (schedule and btw) appear. All plugin skills show correctly under the Plugins submenu.

Root Cause

Custom global commands in ~/.claude/commands/ are not appearing in the slash command menu (either via / filter or the + → "Slash commands" UI). Only two plugin-provided skills (schedule and btw) appear. All plugin skills show correctly under the Plugins submenu.

Code Example

~/.claude/commands/
├── checkpoint.md
├── commit.md
├── debrief.md
├── monthly-review.md
├── obsidian-sync.md
├── orchestrate.md
├── plan-master.md
├── prep.md
├── prettygithub.md
├── ready-to-build.md
├── research-bookmarks.md
├── roadmap-with-validation.md
├── session-end.md
├── session-start.md
└── greenhouse/
    └── (subcommands)

---

---
description: Smart commit - run tests, generate message, commit
---
RAW_BUFFERClick to expand / collapse

Description

Custom global commands in ~/.claude/commands/ are not appearing in the slash command menu (either via / filter or the + → "Slash commands" UI). Only two plugin-provided skills (schedule and btw) appear. All plugin skills show correctly under the Plugins submenu.

Environment

  • Claude Code version: 2.1.110
  • Platform: macOS (Darwin 25.3.0), Claude Code Desktop app
  • Plugins enabled: ~35 (see list below)
  • MCP connectors: ~20 enabled

Steps to Reproduce

  1. Have 16 properly formatted .md command files in ~/.claude/commands/ (with YAML frontmatter including description field)
  2. Have many plugins enabled in settings.json (enabledPlugins)
  3. Type / in the input box — only schedule and btw appear (both from plugins)
  4. Click + → "Slash commands" — only plugin skill categories are listed, no global commands

Expected Behavior

Global commands from ~/.claude/commands/ (e.g., commit, session-start, session-end, checkpoint, etc.) should appear in the / menu alongside plugin skills.

Actual Behavior

  • / filter shows only 2 items: schedule and btw (both plugin skills)
  • + → "Slash commands" shows only plugin skill categories (Operations, PDF viewer, Human resources, Design, Brand voice, etc.)
  • No custom global commands appear anywhere in the UI
  • This was working previously — regression at some point

Command Files (all valid)

~/.claude/commands/
├── checkpoint.md
├── commit.md
├── debrief.md
├── monthly-review.md
├── obsidian-sync.md
├── orchestrate.md
├── plan-master.md
├── prep.md
├── prettygithub.md
├── ready-to-build.md
├── research-bookmarks.md
├── roadmap-with-validation.md
├── session-end.md
├── session-start.md
└── greenhouse/
    └── (subcommands)

Example frontmatter (commit.md):

---
description: Smart commit - run tests, generate message, commit
---

Enabled Plugins

superpowers, commit-commands, plugin-dev, claude-md-management, claude-code-setup, feature-dev, code-review, code-simplifier, pr-review-toolkit, agent-sdk-dev, frontend-design, ralph-loop, hookify, skill-creator, playground, vercel, slack, stripe, explanatory-output-style, learning-output-style, imessage, codex, rust-analyzer-lsp, typescript-lsp, pyright-lsp, playwright, supabase, linear, greptile, github, huggingface-skills, context7

Hypothesis

With many plugins enabled, plugin skill discovery may be suppressing or replacing global command discovery entirely. Several plugin skills share names with global commands (e.g., commit, session-start, session-end), which may contribute to the issue.

extent analysis

TL;DR

Disable plugins that share names with global commands to resolve the custom global command visibility issue in the slash command menu.

Guidance

  • Review the list of enabled plugins and identify those that share names with global commands (e.g., commit, session-start, session-end).
  • Disable these plugins temporarily to verify if they are causing the issue.
  • Check the ~/.claude/commands/ directory to ensure that all command files have valid YAML frontmatter, including the description field.
  • Consider renaming global commands to avoid naming conflicts with plugin skills.

Example

No code snippet is provided as it is not necessary for this issue.

Notes

The issue may be related to plugin skill discovery suppressing global command discovery. Disabling conflicting plugins or renaming global commands may resolve the issue. However, this is not a definitive solution and further investigation may be required.

Recommendation

Apply workaround: Disable plugins that share names with global commands to resolve the issue, as it is likely that these plugins are causing the conflict.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING