kuberwastaken c99507ca1e hello world

2026-04-01 01:20:27 +05:30

69 KiB

Raw Blame History

Claude Code — Commands Reference

This document is an exhaustive reference for every slash command in the Claude Code CLI, derived directly from the source in src/commands/ and the top-level registry in src/commands.ts.

Command System Architecture
Command Type Definitions
Command Registry (commands.ts)
Individual Command Reference
- add-dir
- advisor
- agents
- ant-trace
- autofix-pr
- backfill-sessions
- branch / fork
- break-cache
- bridge-kick
- bridge / remote-control / rc
- brief
- btw
- bughunter
- chrome
- clear / reset / new
- color
- commit
- commit-push-pr
- compact
- config / settings
- context
- copy
- cost
- createMovedToPluginCommand (utility)
- ctx_viz
- debug-tool-call
- desktop / app
- diff
- doctor
- effort
- env
- exit / quit
- export
- extra-usage
- fast
- feedback / bug
- files
- good-claude
- heapdump
- help
- hooks
- ide
- init
- init-verifiers
- insights
- install-github-app
- install-slack-app
- install (component)
- issue
- keybindings
- login
- logout
- mcp
- memory
- mobile / ios / android
- mock-limits
- model
- oauth-refresh
- onboarding
- output-style
- passes
- perf-issue
- permissions / allowed-tools
- plan
- plugin / plugins / marketplace
- pr-comments
- privacy-settings
- rate-limit-options
- release-notes
- reload-plugins
- remote-env
- remote-setup / web-setup
- rename
- reset-limits
- resume / continue
- review
- ultrareview
- rewind / checkpoint
- sandbox
- security-review
- session / remote
- share
- skills
- stats
- status
- statusline
- stickers
- summary
- tag
- tasks / bashes
- teleport
- terminal-setup
- theme
- think-back
- thinkback-play
- ultraplan
- upgrade
- usage
- version
- vim
- voice
Internal-Only Commands Summary
Remote-Safe Commands
Bridge-Safe Commands
Command Availability & Feature Flags

1. Command System Architecture

All slash commands in Claude Code share a unified Command interface defined in src/types/command.ts and re-exported from src/commands.ts. The command registry is loaded lazily (memoized) in commands.ts and is assembled from several sources:

Priority order in getCommands():
  bundledSkills → builtinPluginSkills → skillDirCommands →
  workflowCommands → pluginCommands → pluginSkills → COMMANDS()

The three command types are:

Type	Description
`'local'`	Runs synchronously; returns `LocalCommandResult` (`{ type: 'text' \| 'compact' \| 'skip', value?: string }`)
`'local-jsx'`	Renders a React/Ink component in the TUI; returns `React.ReactNode`
`'prompt'`	Expands to a text prompt that is sent to the model via the main loop

Lazy Loading

Every command's implementation is loaded via dynamic import() from its load() method. The index file contains only metadata (name, description, type) so that startup cost is minimized. The heavy module is only loaded when the command is first invoked.

2. Command Type Definitions

// Base for all command types
interface CommandBase {
  name: string
  description: string
  aliases?: string[]
  argumentHint?: string
  isEnabled?: () => boolean
  isHidden?: boolean
  availability?: Array<'claude-ai' | 'console'>
  source?: 'builtin' | 'plugin' | 'mcp' | 'bundled' | string
  load: () => Promise<{ call: Function }>
}

// 'local' command — synchronous, returns text
interface LocalCommand extends CommandBase {
  type: 'local'
  supportsNonInteractive?: boolean
}

// 'local-jsx' command — renders Ink UI
interface LocalJSXCommand extends CommandBase {
  type: 'local-jsx'
  immediate?: boolean   // skip the "processing" spinner
}

// 'prompt' command — expanded and sent to the model
interface PromptCommand extends CommandBase {
  type: 'prompt'
  contentLength: number
  progressMessage: string
  allowedTools?: string[]
  disableModelInvocation?: boolean
  disableNonInteractive?: boolean
  getPromptForCommand(args: string, context: ToolUseContext): Promise<ContentBlockParam[]>
}

3. Command Registry (`commands.ts`)

File: src/commands.ts

Exports

Export	Description
`getCommands(cwd)`	Async; returns all commands filtered by `meetsAvailabilityRequirement` and `isCommandEnabled`. Memoized per-cwd for expensive loading; availability/isEnabled run fresh every call.
`INTERNAL_ONLY_COMMANDS`	Array of commands only available when `USER_TYPE === 'ant'`. Includes backfill-sessions, break-cache, bughunter, commit, commit-push-pr, ctx_viz, good-claude, issue, init-verifiers, mock-limits, bridge-kick, version, ultraplan, subscribePr, resetLimits, onboarding, share, summary, teleport, ant-trace, perf-issue, env, oauth-refresh, debug-tool-call, agents-platform, autofix-pr.
`REMOTE_SAFE_COMMANDS`	`Set<Command>` of commands safe in remote (--remote) mode: session, exit, clear, help, theme, color, vim, cost, usage, copy, btw, feedback, plan, keybindings, statusline, stickers, mobile.
`BRIDGE_SAFE_COMMANDS`	`Set<Command>` of `'local'` commands safe over the Remote Control bridge: compact, clear, cost, summary, release-notes, files.
`builtInCommandNames`	Memoized `Set<string>` of all built-in command names and aliases.
`meetsAvailabilityRequirement(cmd)`	Checks `cmd.availability` against current auth state.
`filterCommandsForRemoteMode(commands)`	Filters to only REMOTE_SAFE_COMMANDS.
`isBridgeSafeCommand(cmd)`	Returns `true` for `'prompt'` type or BRIDGE_SAFE_COMMANDS members; `false` for `'local-jsx'`.
`findCommand(name, commands)`	Lookup by name, computed name, or alias.
`hasCommand(name, commands)`	Boolean version of findCommand.
`getCommand(name, commands)`	Like findCommand but throws `ReferenceError` if not found.
`formatDescriptionWithSource(cmd)`	User-facing description with source annotation (plugin name, bundled, skill dir).
`getSkillToolCommands(cwd)`	Memoized; filters to prompt-type commands the model can invoke as tools.
`getSlashCommandToolSkills(cwd)`	Memoized; filters to true skills (skills/plugin/bundled).
`getMcpSkillCommands(mcpCommands)`	Filters MCP commands to model-invocable prompt skills.
`clearCommandMemoizationCaches()`	Clears loadAllCommands and skill index caches.
`clearCommandsCache()`	Full reset including plugin and skill caches.

Feature-Gated Commands

The following commands are conditionally registered using feature() bundle flags:

Feature Flag	Command
`BRIDGE_MODE`	`/remote-control` (rc)
`BRIDGE_MODE` + `DAEMON`	`remoteControlServer`
`KAIROS` or `KAIROS_BRIEF`	`/brief`
`KAIROS`	`assistant`
`VOICE_MODE`	`/voice`
`HISTORY_SNIP`	`force-snip`
`WORKFLOW_SCRIPTS`	`workflows`
`CCR_REMOTE_SETUP`	`/web-setup`
`ULTRAPLAN`	`/ultraplan`
`KAIROS_GITHUB_WEBHOOKS`	`subscribe-pr`
`TORCH`	`torch`
`UDS_INBOX`	`peers`
`FORK_SUBAGENT`	`fork`
`BUDDY`	`buddy`
`PROACTIVE` or `KAIROS`	`proactive`
`EXPERIMENTAL_SKILL_SEARCH`	clearSkillIndexCache hook

4. Individual Command Reference

`/add-dir`

Files: commands/add-dir/index.ts, commands/add-dir/add-dir.tsx, commands/add-dir/validation.ts

Type: local-jsx Syntax: /add-dir [<path>] Description: Add a new working directory to the current session's permission context.

Behavior:

If a path argument is provided, validates it and adds it immediately (with an optional "remember" step prompting to save to local settings).
If no path is provided, opens the AddWorkspaceDirectory interactive picker component.
On success, calls applyPermissionUpdate (session) and optionally persistPermissionUpdate (local settings).
Also calls SandboxManager.refreshConfig() to update bash sandboxing configuration.
Updates bootstrap state for additional CLAUDE.md directories.

Validation (validation.ts):

export type AddDirectoryResult =
  | { resultType: 'success'; absolutePath: string }
  | { resultType: 'emptyPath' }
  | { resultType: 'pathNotFound' | 'notADirectory'; directoryPath: string; absolutePath: string }
  | { resultType: 'alreadyInWorkingDirectory'; directoryPath: string; workingDir: string }

export async function validateDirectoryForWorkspace(
  directoryPath: string,
  permissionContext: ToolPermissionContext,
): Promise<AddDirectoryResult>

export function addDirHelpMessage(result: AddDirectoryResult): string

Key logic:

Expands ~ and resolves symlinks before validation.
Handles ENOENT, ENOTDIR, EACCES, EPERM gracefully (returns pathNotFound rather than throwing).
Checks pathInWorkingPath to avoid adding redundant subdirectories.

Dependencies: chalk, bootstrap/state.js, components/permissions/rules/AddWorkspaceDirectory, utils/permissions/PermissionUpdate.js, utils/sandbox/sandbox-adapter.js

`/advisor`

File: commands/advisor.ts

Type: local Syntax: /advisor [<model>|off|unset] Description: Configure the advisor model (a secondary model that reviews/advises on the primary model's outputs).

Arguments:

Argument	Description
(none)	Display current advisor setting and status
`<model>`	Set the advisor model (e.g. `opus`, `claude-opus-4-5`)
`off` / `unset`	Disable the advisor

Behavior:

Checks canUserConfigureAdvisor() — command is hidden/disabled if user cannot configure an advisor.
Validates model string via validateModel().
Checks isValidAdvisorModel() and modelSupportsAdvisor().
Persists to userSettings.advisorModel via updateSettingsForSource.
If base model doesn't support advisors, returns a warning (still sets the value).

Gate: isEnabled: () => canUserConfigureAdvisor()

Dependencies: utils/advisor.js, utils/model/model.js, utils/model/validateModel.js, utils/settings/settings.js

`/agents`

Files: commands/agents/index.ts, commands/agents/agents.tsx

Type: local-jsx Syntax: /agents Description: Open the Agents management menu (create, edit, delete custom agent configurations).

Behavior: Renders the AgentsMenu component passing current tools from getTools(permissionContext).

Dependencies: components/agents/AgentsMenu, tools.js

`/ant-trace` (stub)

File: commands/ant-trace/index.js

Type: Stub — isEnabled: () => false, isHidden: true Description: Internal tracing command. Disabled in all external builds.

`/autofix-pr` (stub)

File: commands/autofix-pr/index.js

Type: Stub — disabled in all external builds.

`/backfill-sessions` (stub)

File: commands/backfill-sessions/index.js

Type: Stub — disabled in all external builds.

`/branch` / `/fork`

Files: commands/branch/index.ts, commands/branch/branch.ts

Type: local-jsx Syntax: /branch [name] Description: Create a forked copy (branch) of the current conversation at this point. The user immediately enters the fork; the original can be resumed with claude -r <original-session-id>.

Arguments:

Argument	Description
`[name]`	Optional custom title for the branch (defaults to first-prompt-derived kebab title + " (Branch)")

Aliases: When the FORK_SUBAGENT feature flag is off, also registered as /fork.

Behavior:

Reads the current transcript JSONL file.
Generates a new UUID for the fork session.
Copies all non-sidechain messages, rewriting sessionId and adding forkedFrom traceability metadata to each entry.
Copies content-replacement entries (rewriting sessionId) to preserve prompt-cache budgeting.
Saves the fork to a new JSONL file.
Calls getUniqueForkName() to avoid collisions (appends " (Branch 2)", " (Branch 3)", etc.).
Calls context.resume(sessionId, forkLog, 'fork') to switch the live session into the fork.

Exports:

export function deriveFirstPrompt(firstUserMessage): string
export async function call(onDone, context, args): Promise<React.ReactNode>

Dependencies: crypto, fs/promises, bootstrap/state.js, utils/sessionStorage.js, services/analytics/index.js

`/break-cache` (stub)

File: commands/break-cache/index.js

Type: Stub — disabled in all external builds.

`/bridge-kick`

File: commands/bridge-kick.ts

Type: local Syntax: /bridge-kick <subcommand> [args...] Description: Internal command to inject bridge (Remote Control) failure states for manual recovery path testing. Only enabled when USER_TYPE === 'ant'.

Subcommands:

Subcommand	Arguments	Description
`close`	`<code>`	Fire WebSocket close event with given code (e.g. 1002, 1006)
`poll`	`<status>` or `transient`	Next poll throws BridgeFatalError(status) or a transient rejection
`poll`	`<status> <type>`	Poll error with explicit error_type
`register`	`fail [N]`	Next N registerBridgeEnvironment calls transient-fail (default 1)
`register`	`fatal`	Next register 403s (terminal failure)
`reconnect-session`	`fail`	Next 2 POST /bridge/reconnect calls return 404
`heartbeat`	`<status>`	Next heartbeat throws BridgeFatalError(status)
`reconnect`	(none)	Call reconnectEnvironmentWithSession() directly
`status`	(none)	Print current bridge state

Gate: isEnabled: () => process.env.USER_TYPE === 'ant'

Dependencies: bridge/bridgeDebug.js

`/bridge` / `/remote-control` / `/rc`

Files: commands/bridge/index.ts, commands/bridge/bridge.tsx

Type: local-jsx Name: remote-control Aliases: rc Syntax: /remote-control [name] Description: Start or manage a Remote Control bridge session, allowing the terminal to be controlled from a mobile device or web interface.

Feature gate: BRIDGE_MODE feature flag must be on AND isBridgeEnabled() must return true.

The implementation (bridge.tsx) is a large file (~34KB) rendering a multi-step wizard for QR code display, session naming, connection state, and error recovery.

Arguments:

Argument	Description
`[name]`	Optional session name to display in the remote client

Properties:

immediate: true — renders immediately without spinner
isHidden: mirrors isEnabled()

`/brief`

File: commands/brief.ts

Type: local-jsx Syntax: /brief Description: Toggle "brief-only mode." When enabled, the model must use the SendUserMessage (Brief) tool for all user-facing output; plain text is hidden. Feature-gated via KAIROS or KAIROS_BRIEF bundle flags + GrowthBook config tengu_kairos_brief_config.enable_slash_command.

Behavior:

Checks entitlement via isBriefEntitled() — if trying to enable and not entitled, logs analytics and returns an error.
Toggles setUserMsgOptIn and context.setAppState({ isBriefOnly }).
Injects a <system-reminder> meta-message into the next turn (unless Kairos is active) so the model immediately transitions its output style.
Logs tengu_brief_mode_toggled event.

Properties: immediate: true

`/btw`

Files: commands/btw/index.ts, commands/btw/btw.tsx

Type: local-jsx Syntax: /btw <question> Description: Ask a quick "by the way" side question without interrupting the main conversation. Opens a scrollable overlay with a spinner, sends the question as a forked side-query to the model, and returns the response in a scrollable panel. Pressing Enter/Escape/Space dismisses the result.

Properties: immediate: true — renders without spinner.

Behavior:

Uses runSideQuestion() to send the question with an abbreviated context (messages after the compact boundary, with cache-safe params from the last turn).
Renders markdown response in a ScrollBox.
Keyboard: Up/Down or Ctrl+P/Ctrl+N to scroll; Escape/Enter/Space/Ctrl+C/Ctrl+D to dismiss.

Dependencies: utils/sideQuestion.js, components/Markdown, ink/components/ScrollBox

`/bughunter` (stub)

File: commands/bughunter/index.js

Type: Stub — disabled in all external builds.

`/chrome`

Files: commands/chrome/index.ts, commands/chrome/chrome.tsx

Type: local-jsx Syntax: /chrome Description: Claude in Chrome (Beta) settings. Available only to claude-ai subscribers and non-interactive session check.

Gate: availability: ['claude-ai'], isEnabled: () => !getIsNonInteractiveSession()

The implementation (chrome.tsx, ~23KB) renders a settings panel for managing the Claude Chrome extension integration.

`/clear` / `/reset` / `/new`

Files: commands/clear/index.ts, commands/clear/clear.ts, commands/clear/conversation.ts, commands/clear/caches.ts

Type: local Syntax: /clear Aliases: reset, new Description: Clear conversation history and free up context. Starts a fresh session.

Core function (clearConversation):

Executes SessionEnd hooks (bounded by CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS, default 1.5s).
Emits tengu_cache_eviction_hint analytics event.
Identifies background tasks to preserve (tasks with isBackgrounded !== false).
Clears messages: setMessages(() => []).
Calls clearSessionCaches(preservedAgentIds).
Resets cwd to original cwd, clears readFileState, discoveredSkillNames, loadedNestedMemoryPaths.
Kills/aborts foreground tasks (local shell tasks get kill()+cleanup(); agent tasks get abortController.abort()).
Clears attribution state, file history, and MCP client state in AppState.
Clears plan slugs and session metadata.
Regenerates session ID (sets old as parent for analytics).
Re-points task output symlinks for surviving background tasks.
Persists mode (coordinator/normal) and worktree state.
Executes SessionStart hooks after clearing.

clearSessionCaches() (caches.ts): Clears user/system/git context caches, file suggestions, commands/skills cache, prompt cache break detection, system prompt injection, emitted date, post-compact cleanup, skill names, memory files cache, stored images, session ingress, pending permission callbacks, tungsten session tracking, attribution caches, repository caches, bash command prefix caches, dump prompts state, invoked skills, git dir resolution, dynamic skills, LSP diagnostics, magic docs tracking, session env vars, WebFetch URL cache, ToolSearch description cache, agent definitions cache, SkillTool prompt cache.

Gate: supportsNonInteractive: false

`/color`

Files: commands/color/index.ts, commands/color/color.ts

Type: local-jsx Syntax: /color <color|default> Description: Set the prompt bar / session color. Colors are drawn from AGENT_COLORS (the same palette used by swarm agents).

Arguments:

Argument	Description
`<color>`	A named color from `AGENT_COLORS`
`default` / `reset` / `none` / `gray` / `grey`	Reset to default (no color)

Behavior:

Saves color to transcript via saveAgentColor().
Updates AppState.standaloneAgentContext.color for immediate display.
Blocked for swarm teammates (their colors are assigned by the team leader).

Properties: immediate: true

`/commit`

File: commands/commit.ts

Type: prompt Syntax: /commit Description: Create a git commit using the current staged and unstaged changes.

Allowed tools:

Bash(git add:*)
Bash(git status:*)
Bash(git commit:*)

Prompt behavior:

Injects live shell output via executeShellCommandsInPrompt for: git status, git diff HEAD, git branch --show-current, git log --oneline -10.
Provides a Git Safety Protocol in the prompt (never amend, never skip hooks, etc.).
If USER_TYPE === 'ant' and isUndercover(), prepends undercover instructions.
Includes optional commit attribution text from getAttributionTexts().
Instructs model to create a commit using HEREDOC syntax.

Gate: Internal-only (INTERNAL_ONLY_COMMANDS).

`/commit-push-pr`

File: commands/commit-push-pr.ts

Type: prompt Syntax: /commit-push-pr [additional instructions] Description: Commit, push, and open a pull request in a single operation.

Allowed tools:

Bash(git checkout --branch:*)
Bash(git checkout -b:*)
Bash(git add:*)
Bash(git status:*)
Bash(git push:*)
Bash(git commit:*)
Bash(gh pr create:*)
Bash(gh pr edit:*)
Bash(gh pr view:*)
Bash(gh pr merge:*)
ToolSearch
mcp__slack__send_message
mcp__claude_ai_Slack__slack_send_message

Prompt behavior:

Injects live shell output for: git status, git diff HEAD, git branch --show-current, git diff ${defaultBranch}...HEAD, gh pr view --json number.
Orchestrates: create branch if on main, commit, push, create/update PR.
Optionally posts to Slack if CLAUDE.md mentions Slack channels (uses ToolSearch).
PR body template includes Summary, Test plan, Changelog sections.
Includes getEnhancedPRAttribution() text.

Gate: Internal-only (INTERNAL_ONLY_COMMANDS).

`/compact`

Files: commands/compact/index.ts, commands/compact/compact.ts

Type: local Syntax: /compact [custom summarization instructions] Description: Summarize the conversation, replacing message history with a compact summary. Preserves context while reducing token usage.

Arguments:

Argument	Description
`[instructions]`	Optional custom instructions to guide the compaction summary

Behavior:

Filters messages to those after the compact boundary (strips UI-only scrollback).
If no custom instructions, first tries trySessionMemoryCompaction() (session-memory-based, cheaper).
If REACTIVE_COMPACT flag is on, routes through the reactive compaction path.
Otherwise falls back to traditional compaction:
- Runs microcompactMessages() first to reduce tokens.
- Calls compactConversation() with cache-sharing parameters.
After success: clears user context cache, runs runPostCompactCleanup(), suppresses the compact warning.
Returns { type: 'compact', compactionResult, displayText }.

Gate: isEnabled: () => !isEnvTruthy(process.env.DISABLE_COMPACT), supportsNonInteractive: true

`/config` / `/settings`

Files: commands/config/index.ts, commands/config/config.tsx

Type: local-jsx Syntax: /config Aliases: settings Description: Open the interactive configuration panel (Settings component, defaulting to the "Config" tab).

`/context`

Files: commands/context/index.ts, commands/context/context-noninteractive.ts, commands/context/context.tsx

Type: local-jsx (interactive) or local (non-interactive) Syntax: /context Description: Visualize or display current context usage.

Two variants:

Interactive (context): local-jsx, renders a colored visualization grid. Enabled when !getIsNonInteractiveSession().
Non-interactive (contextNonInteractive): local, outputs a markdown table with token breakdown. Enabled when getIsNonInteractiveSession().

Output (non-interactive markdown table includes):

Total tokens / max tokens / percentage
Context strategy (collapse stats if CONTEXT_COLLAPSE is on)
Estimated usage by category
MCP Tools breakdown
ANT-ONLY: System Tools, System Prompt Sections
Custom Agents (by source: Project/User/Local/Flag/Policy/Plugin/Built-in)
Memory Files (type, path, tokens)
Skills (name, source, tokens)
ANT-ONLY: Message Breakdown (tool calls, tool results, attachments, assistant messages, user messages; top tools by call+result tokens; top attachments)

Core function:

export async function collectContextData(context): Promise<ContextData>
export async function call(_args, context): Promise<{ type: 'text'; value: string }>

`/copy`

Files: commands/copy/index.ts, commands/copy/copy.tsx

Type: local-jsx Syntax: /copy [N] Description: Copy Claude's last response to the clipboard. /copy N copies the Nth-latest response.

The implementation (copy.tsx, ~31KB) handles clipboard access, finds the most recent assistant message(s), and copies their text content.

`/cost`

Files: commands/cost/index.ts, commands/cost/cost.ts

Type: local Syntax: /cost Description: Show the total cost and duration of the current session.

Behavior:

For claude-ai subscribers: shows subscription usage message (or overage notice).
For API users: calls formatTotalCost() to show token cost.
ANT users always see cost breakdown even if subscriber.

Gate: Hidden for claude.ai subscribers (except ANT users). supportsNonInteractive: true

`createMovedToPluginCommand` (utility)

File: commands/createMovedToPluginCommand.ts

Not a slash command itself — a factory function used to create commands that have been migrated to the plugin marketplace.

export function createMovedToPluginCommand(options: {
  name: string
  description: string
  progressMessage: string
  pluginName: string
  pluginCommand: string
  getPromptWhileMarketplaceIsPrivate(args, context): Promise<ContentBlockParam[]>
}): Command

Behavior: For USER_TYPE === 'ant', returns a prompt instructing the model to tell the user to install the plugin. For external users, runs the fallback getPromptWhileMarketplaceIsPrivate function. Used by pr-comments, security-review.

`/ctx_viz` (stub)

File: commands/ctx_viz/index.js

Type: Stub — disabled in all external builds.

`/debug-tool-call` (stub)

File: commands/debug-tool-call/index.js

Type: Stub — disabled in all external builds.

`/desktop` / `/app`

Files: commands/desktop/index.ts, commands/desktop/desktop.tsx

Type: local-jsx Syntax: /desktop Aliases: app Description: Continue the current session in Claude Desktop via handoff.

Gate:

availability: ['claude-ai']
isEnabled: only macOS or Windows x64

Behavior: Renders DesktopHandoff component which generates a handoff token/URL to open in the Claude Desktop app.

`/diff`

Files: commands/diff/index.ts, commands/diff/diff.tsx

Type: local-jsx Syntax: /diff Description: View uncommitted git changes and per-turn diffs. Renders an interactive diff viewer.

`/doctor`

Files: commands/doctor/index.ts, commands/doctor/doctor.tsx

Type: local-jsx Syntax: /doctor Description: Run diagnostics on the Claude Code installation: API key validity, model access, MCP connectivity, LSP status, plugin health, etc.

Gate: isEnabled: () => !isEnvTruthy(process.env.DISABLE_DOCTOR_COMMAND)

`/effort`

Files: commands/effort/index.ts, commands/effort/effort.tsx

Arguments:

Value	Description
`low`	Minimal thinking tokens
`medium`	Moderate thinking tokens
`high`	Extended thinking
`max`	Maximum thinking tokens
`auto`	Model decides
`help` / `-h` / `--help`	Show help
(none)	Show current level

Behavior:

Calls toPersistableEffort() — some levels are session-only.
Persists persistable values to userSettings.effortLevel.
Logs tengu_effort_command analytics event.
If CLAUDE_CODE_EFFORT_LEVEL env var is set and conflicts with the requested value, warns the user.

immediate: Dynamically set by shouldInferenceConfigCommandBeImmediate().

`/env` (stub)

File: commands/env/index.js

Type: Stub — disabled in all external builds.

`/exit` / `/quit`

Files: commands/exit/index.ts, commands/exit/exit.tsx

Type: local-jsx Syntax: /exit Aliases: quit Description: Exit the REPL gracefully.

Behavior:

If BG_SESSIONS flag is on and this is a --bg tmux session: detaches the tmux client instead of killing it.
If in a worktree session: shows ExitFlow dialog (asks about worktree cleanup).
Otherwise: calls gracefulShutdown(0, 'prompt_input_exit') with a random goodbye message from ['Goodbye!', 'See ya!', 'Bye!', 'Catch you later!'].

Properties: immediate: true

`/export`

Files: commands/export/index.ts, commands/export/export.tsx

Type: local-jsx Syntax: /export [filename] Description: Export the current conversation to a file or clipboard.

The implementation (~31KB) handles multiple formats, clipboard copy, and file output.

`/extra-usage`

Files: commands/extra-usage/index.ts, commands/extra-usage/extra-usage-core.ts, commands/extra-usage/extra-usage-noninteractive.ts, commands/extra-usage/extra-usage.tsx

Two variants:

extraUsage: local-jsx, for interactive sessions
extraUsageNonInteractive: local, for --print / headless mode

Syntax: /extra-usage Description: Configure extra usage (overage) to keep working when subscription limits are hit.

Gate: isEnabled: () => isOverageProvisioningAllowed() && !isEnvTruthy(DISABLE_EXTRA_USAGE_COMMAND)

Core logic (extra-usage-core.ts):

Marks hasVisitedExtraUsage in global config.
Invalidates overage credit grant cache.
For Team/Enterprise without billing access:
- If unlimited overage already enabled → "already have unlimited."
- If admin request pending/dismissed → "already submitted."
- Creates an admin_request of type limit_increase.
For users with billing access or individual plans: opens browser to claude.ai/settings/usage or claude.ai/admin-settings/usage.

`/fast`

Files: commands/fast/index.ts, commands/fast/fast.tsx

Type: local-jsx Syntax: /fast [on|off] Description: Toggle "fast mode" — switches to a faster, cheaper model (displayed as FAST_MODE_MODEL_DISPLAY).

Gate:

availability: ['claude-ai', 'console']
isEnabled: () => isFastModeEnabled()
isHidden: !isFastModeEnabled()

Behavior:

Clears fast mode cooldown.
Writes fastMode: true/undefined to userSettings.
If enabling and current model doesn't support fast mode, also switches mainLoopModel.
Prefetches fast mode status on render.
Shows a picker dialog (FastModePicker) with pricing info and cooldown status.

immediate: Set by shouldInferenceConfigCommandBeImmediate().

`/feedback` / `/bug`

Files: commands/feedback/index.ts, commands/feedback/feedback.tsx

Type: local-jsx Syntax: /feedback [report] Aliases: bug Description: Submit feedback or bug reports about Claude Code.

Gate: Disabled when:

CLAUDE_CODE_USE_BEDROCK, CLAUDE_CODE_USE_VERTEX, CLAUDE_CODE_USE_FOUNDRY are set
DISABLE_FEEDBACK_COMMAND or DISABLE_BUG_COMMAND set
isEssentialTrafficOnly() is true
USER_TYPE === 'ant'
!isPolicyAllowed('allow_product_feedback')

`/files`

Files: commands/files/index.ts, commands/files/files.ts

Type: local Syntax: /files Description: List all files currently in the context (read state cache).

Gate: isEnabled: () => process.env.USER_TYPE === 'ant'

Output: Lists relative paths of all files in readFileState cache, or "No files in context."

supportsNonInteractive: true

`/good-claude` (stub)

File: commands/good-claude/index.js

Type: Stub — disabled in all external builds.

`/heapdump`

Files: commands/heapdump/index.ts, commands/heapdump/heapdump.ts

Type: local Syntax: /heapdump Description: Dump the JavaScript heap to ~/Desktop.

isHidden: true — not shown in help but accessible. supportsNonInteractive: true

Output: Prints heapPath and diagPath on success, or an error message.

`/help`

Files: commands/help/index.ts, commands/help/help.tsx

Type: local-jsx Syntax: /help Description: Show help screen with available commands and keyboard shortcuts.

`/hooks`

Files: commands/hooks/index.ts, commands/hooks/hooks.tsx

Type: local-jsx Syntax: /hooks Description: View and manage hook configurations for tool events (PreToolUse, PostToolUse, Stop, etc.).

Properties: immediate: true

`/ide`

Files: commands/ide/index.ts, commands/ide/ide.tsx

Type: local-jsx Syntax: /ide [open] Description: Manage IDE integrations (VS Code, JetBrains, etc.) and show connection status.

`/init`

File: commands/init.ts

Type: prompt Syntax: /init Description: Initialize CLAUDE.md (and optionally skills/hooks) for the current repository.

Two prompt variants (feature-gated):

Old prompt (OLD_INIT_PROMPT): Analyzes the codebase and creates a minimal CLAUDE.md with commands, architecture overview.

New prompt (NEW_INIT_PROMPT, enabled by NEW_INIT flag or CLAUDE_CODE_NEW_INIT=1): Multi-phase interactive setup:

Phase 1: Ask what to set up (project CLAUDE.md, personal CLAUDE.local.md, skills, hooks)
Phase 2: Explore codebase (manifest files, README, CI config, existing CLAUDE.md, linter config, git worktrees)
Phase 3: Fill in gaps via AskUserQuestion
Phase 4: Write CLAUDE.md at project root
Phase 5: Write CLAUDE.local.md (added to .gitignore)
Phase 6: Suggest and create skills in .claude/skills/
Phase 7: Suggest additional optimizations (GitHub CLI, linting, hooks, format-on-edit)
Phase 8: Summary and next steps (plugin suggestions)

Side effect: Calls maybeMarkProjectOnboardingComplete() when invoked.

`/init-verifiers`

File: commands/init-verifiers.ts

Type: prompt Syntax: /init-verifiers Description: Create verifier skill(s) for automated verification of code changes. Creates skills in .claude/skills/ that can be used by the Verify agent.

Multi-phase workflow:

Phase 1: Auto-detect project type and stack (web app → Playwright, CLI → Tmux, API → HTTP)
Phase 2: Verification tool setup (Playwright installation, MCP configuration)
Phase 3: Interactive Q&A (verifier names, dev server details, auth setup)
Phase 4: Generate verifier skills with appropriate allowed-tools
Phase 5: Confirm creation

Verifier types and allowed tools:

Type	Tools
`verifier-playwright`	`Bash(npm:)`, `Bash(yarn:)`, `mcp__playwright__*`, Read, Glob, Grep
`verifier-cli`	Tmux, `Bash(asciinema:*)`, Read, Glob, Grep
`verifier-api`	`Bash(curl:)`, `Bash(http:)`, `Bash(npm:*)`, Read, Glob, Grep

`/insights`

File: commands/insights.ts (lazy-loaded from commands.ts)

Type: prompt Syntax: /insights Description: Generate an AI-powered report analyzing Claude Code usage sessions.

Implementation note: This is a 113KB module (~3200 lines) that includes HTML rendering and diff utilities. It is registered in commands.ts as a lazy shim that dynamically imports the real module only when invoked, to avoid startup overhead.

Key features (from the module):

Reads session files from ~/.claude/projects/
Analyzes conversations, extracts facets and patterns
Runs summarization via Opus model
Generates HTML and diff-line reports
Supports remote Coder host enumeration for internal users

`/install-github-app`

Files: commands/install-github-app/index.ts, plus step components

Type: local-jsx Syntax: /install-github-app Description: Interactive wizard to set up Claude GitHub Actions for a repository.

Gate:

availability: ['claude-ai', 'console']
isEnabled: () => !isEnvTruthy(process.env.DISABLE_INSTALL_GITHUB_APP_COMMAND)

Wizard steps (each is a separate React component):

Component	Purpose
`OAuthFlowStep`	GitHub OAuth authentication
`CheckGitHubStep`	Verify GitHub CLI and remote setup
`ChooseRepoStep`	Select the repository
`CheckExistingSecretStep`	Check for existing ANTHROPIC_API_KEY secret
`ApiKeyStep`	Collect/create API key
`InstallAppStep`	Install the Claude GitHub App
`ExistingWorkflowStep`	Handle existing workflow files
`WarningsStep`	Display security warnings
`CreatingStep`	Create workflow file and secret
`SuccessStep`	Show success and next steps
`ErrorStep`	Display errors

Setup utility (setupGitHubActions.ts): Creates .github/workflows/claude.yml and sets ANTHROPIC_API_KEY repository secret via GitHub API.

`/install-slack-app`

Files: commands/install-slack-app/index.ts, commands/install-slack-app/install-slack-app.ts

Type: local Syntax: /install-slack-app Description: Open the Claude Slack app installation page in the browser.

Gate: availability: ['claude-ai']

Behavior:

Logs tengu_install_slack_app_clicked event.
Increments slackAppInstallCount in global config.
Opens https://slack.com/marketplace/A08SF47R6P4-claude in browser.
Returns URL if browser open fails.

`install` (component)

File: commands/install.tsx

This is a large (~27KB) React component used during the onboarding flow, not a standalone slash command. It handles installation steps, auth setup, and account configuration for first-time users.

`/issue` (stub)

File: commands/issue/index.js

Type: Stub — disabled in all external builds.

`/keybindings`

Files: commands/keybindings/index.ts, commands/keybindings/keybindings.ts

Type: local Syntax: /keybindings Description: Open or create the keybindings configuration file in the user's editor.

Gate: isEnabled: () => isKeybindingCustomizationEnabled() (feature in preview)

Behavior:

Gets keybindings file path from getKeybindingsPath().
Creates parent directory if needed.
Writes a template file (using 'wx' exclusive flag — no-op if exists).
Opens the file in the user's editor via editFileInEditor().

`/login`

Files: commands/login/index.ts, commands/login/login.tsx

Type: local-jsx Syntax: /login Description: Sign in with an account. Description dynamically shows "Switch accounts" if already authenticated.

Gate: isEnabled: () => !isEnvTruthy(process.env.DISABLE_LOGIN_COMMAND)

Post-login actions:

context.onChangeAPIKey() — notifies the app of key change
stripSignatureBlocks on messages (signatures are key-bound)
resetCostState()
refreshRemoteManagedSettings() (non-blocking)
refreshPolicyLimits() (non-blocking)
resetUserCache()
refreshGrowthBookAfterAuthChange()
clearTrustedDeviceToken() + enrollTrustedDevice() (non-blocking)
Killswitch gate resets: resetBypassPermissionsCheck(), resetAutoModeGateCheck()
checkAndDisableBypassPermissionsIfNeeded(), checkAndDisableAutoModeIfNeeded()

`/logout`

Files: commands/logout/index.ts, commands/logout/logout.tsx

Type: local-jsx Syntax: /logout Description: Sign out from account.

Gate: isEnabled: () => !isEnvTruthy(process.env.DISABLE_LOGOUT_COMMAND)

performLogout() steps:

Flushes telemetry (before clearing credentials to prevent org data exposure).
removeApiKey() — deletes API key from storage.
secureStorage.delete() — wipes all secure storage.
Clears auth-related caches: Grove settings, OAuth tokens, policy limits, remote managed settings, betas caches, tool schema cache.
resetUserCache(), refreshGrowthBookAfterAuthChange().
Updates global config (can optionally reset onboarding state).
clearTrustedDeviceTokenCache().
gracefulShutdownSync() to exit.

`/mcp`

Files: commands/mcp/index.ts, commands/mcp/mcp.tsx, commands/mcp/addCommand.ts, commands/mcp/xaaIdpCommand.ts

Type: local-jsx Syntax: /mcp [enable|disable [server-name]] Description: Manage Model Context Protocol (MCP) servers.

Properties: immediate: true

CLI subcommands (mcp add via addCommand.ts):

claude mcp add <name> <commandOrUrl> [args...]
  -s, --scope <scope>        Configuration scope: local, user, project (default: local)
  -t, --transport <type>     Transport: stdio, sse, http (default: stdio)
  -e, --env <env...>         Environment variables (KEY=value)
  -H, --header <header...>   HTTP headers
  --client-id <id>           OAuth client ID
  --client-secret            Prompt for OAuth client secret
  --callback-port <port>     Fixed OAuth callback port
  --xaa                      Enable XAA (SEP-990) authentication

XAA IdP subcommands (claude mcp xaa via xaaIdpCommand.ts):

Subcommand	Description
`xaa setup`	Configure IdP connection: `--issuer <url>` `--client-id <id>` `[--client-secret]` `[--callback-port]`
`xaa login`	Authenticate with IdP (OIDC browser flow). `[--force]` `[--id-token <jwt>]`
`xaa show`	Show current IdP config and login status
`xaa clear`	Clear IdP config and cached id_token

Security notes for mcp xaa setup:

Validates issuer URL: must be https:// (or http://localhost for conformance).
Validates callbackPort is a positive integer.
Clears stale keychain slots when issuer or clientId changes.
Writes settings before clearing keychain to avoid half-cleared state.

`/memory`

Files: commands/memory/index.ts, commands/memory/memory.tsx

Type: local-jsx Syntax: /memory Description: Edit Claude memory files (CLAUDE.md, CLAUDE.local.md, etc.).

`/mobile` / `/ios` / `/android`

Files: commands/mobile/index.ts, commands/mobile/mobile.tsx

Type: local-jsx Syntax: /mobile Aliases: ios, android Description: Show a QR code to download the Claude mobile app.

`/mock-limits` (stub)

File: commands/mock-limits/index.js

Type: Stub — disabled in all external builds.

`/model`

Files: commands/model/index.ts, commands/model/model.tsx

Type: local-jsx Syntax: /model [model] Description: Set the AI model for Claude Code. Description dynamically shows the currently selected model.

immediate: Set by shouldInferenceConfigCommandBeImmediate().

`/oauth-refresh` (stub)

File: commands/oauth-refresh/index.js

Type: Stub — disabled in all external builds.

`/onboarding` (stub)

File: commands/onboarding/index.js

Type: Stub — disabled in all external builds.

`/output-style`

Files: commands/output-style/index.ts, commands/output-style/output-style.tsx

Type: local-jsx Syntax: /output-style Description: Deprecated — use /config to change output style.

isHidden: true — not shown in the command palette.

`/passes`

Files: commands/passes/index.ts, commands/passes/passes.tsx

Type: local-jsx Syntax: /passes Description: Share a free week of Claude Code with friends (referral passes). Optionally shows "earn extra usage" if referrer rewards are available.

Gate: Hidden unless checkCachedPassesEligibility().eligible && hasCache.

`/perf-issue` (stub)

File: commands/perf-issue/index.js

Type: Stub — disabled in all external builds.

`/permissions` / `/allowed-tools`

Files: commands/permissions/index.ts, commands/permissions/permissions.tsx

Type: local-jsx Syntax: /permissions Aliases: allowed-tools Description: Manage allow and deny rules for tool permissions.

`/plan`

Files: commands/plan/index.ts, commands/plan/plan.tsx

Type: local-jsx Syntax: /plan [open|<description>] Description: Enable plan mode or view/edit the current session plan.

Arguments:

Argument	Description
(none)	View current plan or toggle plan mode
`open`	Open the plan file in an external editor
`<description>`	Set/update the plan description

Behavior:

Reads the plan file via getPlan() / getPlanFilePath().
Calls prepareContextForPlanMode() and applyPermissionUpdate() to restrict tools when entering plan mode.
Calls handlePlanModeTransition() in bootstrap state.
If open, launches editFileInEditor() with the plan file path.
Shows PlanDisplay component with plan content, path, and editor hint.

`/plugin` / `/plugins` / `/marketplace`

Files: commands/plugin/index.tsx, commands/plugin/plugin.tsx, plus multiple sub-components and utilities

Type: local-jsx Syntax: /plugin [subcommand] [args] Aliases: plugins, marketplace Description: Manage Claude Code plugins (install, uninstall, enable, disable, browse marketplace).

Properties: immediate: true

Parsed subcommands (parseArgs.ts):

Subcommand	Syntax	Description
(none)	`/plugin`	Open interactive menu
`install` / `i`	`/plugin install [plugin@marketplace]`	Install a plugin
`manage`	`/plugin manage`	Open manage plugins UI
`uninstall`	`/plugin uninstall [plugin]`	Uninstall a plugin
`enable`	`/plugin enable [plugin]`	Enable a plugin
`disable`	`/plugin disable [plugin]`	Disable a plugin
`validate`	`/plugin validate [path]`	Validate a plugin definition
`marketplace`	`/plugin marketplace [add\|remove\|update\|list] [target]`	Manage marketplaces
`help`	`/plugin help`	Show help

Plugin format: plugin-name@marketplace-name or plugin-name@https://marketplace-url

UI components:

ManagePlugins.tsx — list/toggle/remove installed plugins
BrowseMarketplace.tsx — browse marketplace listings
AddMarketplace.tsx — add a new marketplace URL
ManageMarketplaces.tsx — manage registered marketplaces
DiscoverPlugins.tsx — discovery flow for new users
PluginErrors.tsx — display plugin load errors
PluginOptionsDialog.tsx — configure plugin options
PluginOptionsFlow.tsx — step-by-step option configuration
PluginSettings.tsx — plugin settings panel
PluginTrustWarning.tsx — security warning before install
UnifiedInstalledCell.tsx — single plugin row in list
ValidatePlugin.tsx — validation result display
pluginDetailsHelpers.tsx — helpers for displaying plugin info
usePagination.ts — pagination hook for marketplace listings

`/pr-comments`

File: commands/pr_comments/index.ts

Type: prompt (via createMovedToPluginCommand) Syntax: /pr-comments [PR number or args] Description: Get comments from a GitHub pull request. Uses gh CLI to fetch PR-level and code review comments.

Plugin migration: For USER_TYPE === 'ant', directs to pr-comments@claude-code-marketplace. For external users, runs the embedded prompt.

Fallback prompt logic:

gh pr view --json number,headRepository to get PR info.
gh api /repos/{owner}/{repo}/issues/{number}/comments for PR-level comments.
gh api /repos/{owner}/{repo}/pulls/{number}/comments for review comments.
Formats with author, file#line, diff_hunk, comment text.

`/privacy-settings`

Files: commands/privacy-settings/index.ts, commands/privacy-settings/privacy-settings.tsx

Type: local-jsx Syntax: /privacy-settings Description: View and update privacy settings (training data opt-out, etc.).

Gate: isEnabled: () => isConsumerSubscriber()

`/rate-limit-options`

Files: commands/rate-limit-options/index.ts, commands/rate-limit-options/rate-limit-options.tsx

Type: local-jsx Syntax: /rate-limit-options Description: Show options when the rate limit is reached (upgrade, extra usage, etc.). Shown only to claude-ai subscribers.

isHidden: true — only used internally (e.g., triggered from the rate-limit message component, not user-invoked).

`/release-notes`

Files: commands/release-notes/index.ts, commands/release-notes/release-notes.ts

Type: local Syntax: /release-notes Description: Display the changelog for Claude Code.

supportsNonInteractive: true

Behavior:

Tries to fetch fresh changelog via fetchAndStoreChangelog() with a 500ms timeout.
Falls back to cached notes via getStoredChangelog().
If nothing available, shows link to CHANGELOG_URL.
Formats as: Version X.Y.Z:\n· bullet1\n· bullet2

`/reload-plugins`

Files: commands/reload-plugins/index.ts, commands/reload-plugins/reload-plugins.ts

Type: local Syntax: /reload-plugins Description: Activate pending plugin changes in the current session (Layer-3 refresh).

Gate: supportsNonInteractive: false

Behavior:

In remote/CCR mode with DOWNLOAD_USER_SETTINGS flag: re-downloads user settings from server and fires settingsChangeDetector.notifyChange.
Calls refreshActivePlugins(context.setAppState).
Returns summary: "Reloaded: N plugins · N skills · N agents · N hooks · N plugin MCP servers · N plugin LSP servers".
If errors: "N errors during load. Run /doctor for details."

`/remote-env`

Files: commands/remote-env/index.ts, commands/remote-env/remote-env.tsx

Type: local-jsx Syntax: /remote-env Description: Configure the default remote environment for teleport sessions.

Gate:

isEnabled: () => isClaudeAISubscriber() && isPolicyAllowed('allow_remote_sessions')
Hidden when not eligible.

`/remote-setup` / `/web-setup`

Files: commands/remote-setup/index.ts, commands/remote-setup/remote-setup.tsx, commands/remote-setup/api.ts

Type: local-jsx Name: web-setup Description: Set up Claude Code on the web (connects GitHub account).

Gate:

availability: ['claude-ai']
isEnabled: () => getFeatureValue_CACHED_MAY_BE_STALE('tengu_cobalt_lantern', false) && isPolicyAllowed('allow_remote_sessions')
Feature flag: CCR_REMOTE_SETUP

`/rename`

Files: commands/rename/index.ts, commands/rename/rename.ts, commands/rename/generateSessionName.ts

Type: local-jsx Syntax: /rename [name] Description: Rename the current conversation.

Properties: immediate: true

Arguments:

Argument	Description
`[name]`	New name for the session. If omitted, auto-generates one using Haiku.

Behavior:

Blocked for swarm teammates (names set by team leader).
If no name provided: calls generateSessionName(messages, abortSignal):
- Sends conversation text to queryHaiku with a system prompt to generate a 2-4 word kebab-case name.
- Returns JSON { name: string }.
Saves name via saveCustomTitle() and saveAgentName().
Syncs to bridge session title via updateBridgeSessionTitle() if connected.
Updates AppState.standaloneAgentContext.name.

`/reset-limits` (stub)

File: commands/reset-limits/index.js

Type: Stub — exports both resetLimits and resetLimitsNonInteractive as disabled stubs.

`/resume` / `/continue`

Files: commands/resume/index.ts, commands/resume/resume.tsx

Type: local-jsx Syntax: /resume [conversation id or search term] Aliases: continue Description: Resume a previous conversation. Opens a fuzzy-searchable list of recent sessions.

`/review`

File: commands/review.ts

Type: prompt Syntax: /review [PR number] Description: Review a GitHub pull request using gh CLI.

Prompt logic:

If no PR number: runs gh pr list to show open PRs.
If PR number: runs gh pr view <number> and gh pr diff <number>.
Returns a structured code review with Overview, Code quality, Suggestions, Issues/risks sections.

`/ultrareview`

File: commands/review.ts, commands/review/ultrareviewCommand.tsx, commands/review/ultrareviewEnabled.ts, commands/review/reviewRemote.ts, commands/review/UltrareviewOverageDialog.tsx

Type: local-jsx Syntax: /ultrareview Description: Deep automated bug-finding review running in Claude Code on the web (~10–20 min). Finds and verifies bugs in the current branch.

Gate: isEnabled: () => isUltrareviewEnabled() — checks GrowthBook tengu_review_bughunter_config.enabled.

Behavior: Launches a remote agent session (CCR) that runs the bughunter analysis. Shows an overage dialog if free reviews are exhausted.

`/rewind` / `/checkpoint`

Files: commands/rewind/index.ts, commands/rewind/rewind.ts

Type: local Syntax: /rewind Aliases: checkpoint Description: Restore the code and/or conversation to a previous point. Opens the message selector UI.

Gate: supportsNonInteractive: false

Behavior: Calls context.openMessageSelector() and returns { type: 'skip' } (no message appended).

`/sandbox`

Files: commands/sandbox-toggle/index.ts, commands/sandbox-toggle/sandbox-toggle.tsx

Type: local-jsx Syntax: /sandbox [exclude "command pattern"] Description: Configure sandbox settings for bash command execution.

Dynamic description shows current sandbox status: enabled/disabled, auto-allow mode, fallback allowed, managed policy.

isHidden: Hidden on unsupported platforms (!SandboxManager.isSupportedPlatform() or !SandboxManager.isPlatformInEnabledList()). immediate: true

`/security-review`

File: commands/security-review.ts

Type: prompt (via createMovedToPluginCommand) Syntax: /security-review Description: Complete a security-focused review of pending branch changes.

Plugin migration: Directs USER_TYPE === 'ant' users to security-review@claude-code-marketplace.

Fallback prompt: Large SECURITY_REVIEW_MARKDOWN with:

Allowed tools: Bash(git diff:*), Bash(git status:*), Bash(git log:*), Bash(git show:*), Bash(git remote show:*), Read, Glob, Grep, LS, Task
Live shell injection: git status, git diff --name-only origin/HEAD..., git log origin/HEAD..., git diff origin/HEAD...

Analysis methodology: 3-phase (explore codebase, vulnerability scan, false-positive filtering with confidence scoring). Launches parallel sub-tasks for FP filtering.

Security categories: Input validation (SQLi, CMDi, XXE, template injection, NoSQL injection, path traversal), auth/authz, crypto/secrets, injection/RCE, data exposure.

Hard exclusions: DoS, secrets on disk, rate limiting, memory issues, test-only code, log spoofing, SSRF path-only, AI prompt injection, regex, insecure docs, missing audit logs.

`/session` / `/remote`

Files: commands/session/index.ts, commands/session/session.tsx

Type: local-jsx Syntax: /session Aliases: remote Description: Show remote session URL and QR code (for connecting mobile/web clients).

Gate: isEnabled: () => getIsRemoteMode() — only shown in --remote mode.

`/share` (stub)

File: commands/share/index.js

Type: Stub — disabled in all external builds.

`/skills`

Files: commands/skills/index.ts, commands/skills/skills.tsx

Type: local-jsx Syntax: /skills Description: List all available skills (custom commands loaded from skill directories, plugins, and bundled skills).

`/stats`

Files: commands/stats/index.ts, commands/stats/stats.tsx

Type: local-jsx Syntax: /stats Description: Show Claude Code usage statistics and activity (sessions, token usage, costs over time).

`/status`

Files: commands/status/index.ts, commands/status/status.tsx

Type: local-jsx Syntax: /status Description: Show comprehensive Claude Code status: version, model, account, API connectivity, tool statuses.

Properties: immediate: true

`/statusline`

File: commands/statusline.tsx

Type: prompt Syntax: /statusline [description] Description: Set up Claude Code's status line UI. Launches a specialized statusline-setup subagent.

Allowed tools: AgentTool, Read(~/**), Edit(~/.claude/settings.json)

disableNonInteractive: true

Behavior: Creates an AgentTool call with subagent_type: "statusline-setup" and the user's prompt (default: "Configure my statusLine from my shell PS1 configuration").

`/stickers`

Files: commands/stickers/index.ts, commands/stickers/stickers.ts

Type: local Syntax: /stickers Description: Open the Claude Code sticker ordering page at https://www.stickermule.com/claudecode.

Gate: supportsNonInteractive: false

`/summary` (stub)

File: commands/summary/index.js

Type: Stub — disabled in all external builds. Note: This is in BRIDGE_SAFE_COMMANDS and INTERNAL_ONLY_COMMANDS in commands.ts; the non-stub implementation is internal-only.

`/tag`

Files: commands/tag/index.ts, commands/tag/tag.tsx

Type: local-jsx Syntax: /tag <tag-name> Description: Toggle a searchable tag on the current session (for session search/filtering).

Gate: isEnabled: () => process.env.USER_TYPE === 'ant'

`/tasks` / `/bashes`

Files: commands/tasks/index.ts, commands/tasks/tasks.tsx

Type: local-jsx Syntax: /tasks Aliases: bashes Description: List and manage background tasks (running shell commands, agent tasks, etc.).

`/teleport` (stub)

File: commands/teleport/index.js

Type: Stub — disabled in all external builds.

`/terminal-setup`

Files: commands/terminalSetup/index.ts, commands/terminalSetup/terminalSetup.tsx

Type: local-jsx Syntax: /terminal-setup Description: Install terminal keyboard bindings for newline input.

Dynamic description:

Apple Terminal: "Enable Option+Enter key binding for newlines and visual bell"
Other terminals: "Install Shift+Enter key binding for newlines"

isHidden: True for terminals with native CSI-u support (Ghostty, Kitty, iTerm2, WezTerm).

`/theme`

Files: commands/theme/index.ts, commands/theme/theme.tsx

Type: local-jsx Syntax: /theme Description: Change the TUI color theme (dark/light/etc.).

`/think-back`

Files: commands/thinkback/index.ts, commands/thinkback/thinkback.tsx

Type: local-jsx Syntax: /think-back Description: "Your 2025 Claude Code Year in Review" — a year-in-review animation.

Gate: isEnabled: () => checkStatsigFeatureGate_CACHED_MAY_BE_STALE('tengu_thinkback')

`/thinkback-play`

Files: commands/thinkback-play/index.ts, commands/thinkback-play/thinkback-play.ts

Type: local Syntax: /thinkback-play Description: Play the thinkback animation. Hidden command called by the thinkback skill after generation is complete.

Gate: checkStatsigFeatureGate_CACHED_MAY_BE_STALE('tengu_thinkback') isHidden: true, supportsNonInteractive: false

`/ultraplan`

File: commands/ultraplan.tsx

Type: local-jsx Syntax: /ultraplan [seed plan] Description: Run an extended multi-agent planning session on Claude Code on the web (CCR). Explores the codebase, creates a comprehensive implementation plan, and enters plan-approval mode.

Feature gate: ULTRAPLAN bundle flag required.

Constants:

const ULTRAPLAN_TIMEOUT_MS = 30 * 60 * 1000  // 30 min
export const CCR_TERMS_URL = 'https://code.claude.com/docs/en/claude-code-on-the-web'

Model: From GrowthBook tengu_ultraplan_model (defaults to ALL_MODEL_CONFIGS.opus46.firstParty).

Behavior:

Checks checkRemoteAgentEligibility() — returns error if not eligible.
Opens a remote CCR session via teleportToRemote().
Sends the ultraplan prompt (from ultraplan/prompt.txt, inlined at bundle time; ANT builds can override via ULTRAPLAN_PROMPT_FILE env).
Polls pollForApprovedExitPlanMode() every ~5s for up to 30 minutes.
On approval: archives the remote session, updates local app state, transitions to plan mode.
On REMOTE_CONTROL_DISCONNECTED_MSG: falls back gracefully.
Shows CCR terms URL in description for legal visibility.

`/upgrade`

Files: commands/upgrade/index.ts, commands/upgrade/upgrade.tsx

Type: local-jsx Syntax: /upgrade Description: Upgrade to Max plan for higher rate limits and more Opus access.

Gate:

availability: ['claude-ai']
isEnabled: () => !isEnvTruthy(DISABLE_UPGRADE_COMMAND) && getSubscriptionType() !== 'enterprise'

`/usage`

Files: commands/usage/index.ts, commands/usage/usage.tsx

Type: local-jsx Syntax: /usage Description: Show plan usage limits and current consumption.

Gate: availability: ['claude-ai']

`/version`

File: commands/version.ts

Type: local Syntax: /version Description: Print the version this session is running (not what auto-update downloaded).

Gate: isEnabled: () => process.env.USER_TYPE === 'ant'

Output: "${VERSION} (built ${BUILD_TIME})" or just VERSION if no build time.

supportsNonInteractive: true

Note: Uses MACRO.VERSION and MACRO.BUILD_TIME — build-time macros injected by the bundler.

`/vim`

Files: commands/vim/index.ts, commands/vim/vim.ts

Type: local Syntax: /vim Description: Toggle between Vim and Normal (readline) editing modes for the prompt input.

Gate: supportsNonInteractive: false

Behavior:

Reads config.editorMode (handles legacy 'emacs' → 'normal').
Toggles between 'normal' and 'vim'.
Saves to global config.
Logs tengu_editor_mode_changed event with source: 'command'.
Returns description: "Editor mode set to vim/normal. Use Escape key..." / "Using standard (readline) keyboard bindings."

`/voice`

Files: commands/voice/index.ts, commands/voice/voice.ts

Type: local Syntax: /voice Description: Toggle voice mode (speech-to-text input via push-to-talk).

Gate:

availability: ['claude-ai']
isEnabled: () => isVoiceGrowthBookEnabled() — feature-flagged via GrowthBook
isHidden: !isVoiceModeEnabled()
Feature flag: VOICE_MODE bundle flag

Toggle ON pre-flight checks:

isVoiceModeEnabled() — checks kill-switch + auth.
checkRecordingAvailability() — microphone hardware check.
isVoiceStreamAvailable() — checks for API key.
checkVoiceDependencies() — checks for SoX or other audio recording tool.
requestMicrophonePermission() — OS permission probe (fires permission dialog now).

Toggle OFF: No checks needed, always allowed.

On success: updateSettingsForSource('userSettings', { voiceEnabled: true/false }), fires settingsChangeDetector.notifyChange, logs tengu_voice_toggled.

Language hint: Shows STT language on first 2 enables; falls back to English if language not supported.

5. Internal-Only Commands Summary

These commands are registered only when process.env.USER_TYPE === 'ant' and !process.env.IS_DEMO:

Command	Description
`backfill-sessions`	Stub (disabled)
`break-cache`	Stub (disabled)
`bughunter`	Stub (disabled)
`commit`	Git commit via model
`commit-push-pr`	Commit + push + PR via model
`ctx_viz`	Stub (disabled)
`good-claude`	Stub (disabled)
`issue`	Stub (disabled)
`init-verifiers`	Create verifier skills
`force-snip`	Force history snip (feature-gated)
`mock-limits`	Stub (disabled)
`bridge-kick`	Inject bridge failure states
`version`	Print version
`ultraplan`	Remote planning session (feature-gated)
`subscribe-pr`	GitHub webhook subscription (feature-gated)
`reset-limits`	Stub (disabled)
`reset-limits-noninteractive`	Stub (disabled)
`onboarding`	Stub (disabled)
`share`	Stub (disabled)
`summary`	Stub (disabled)
`teleport`	Stub (disabled)
`ant-trace`	Stub (disabled)
`perf-issue`	Stub (disabled)
`env`	Stub (disabled)
`oauth-refresh`	Stub (disabled)
`debug-tool-call`	Stub (disabled)
`agents-platform`	Internal agents platform command
`autofix-pr`	Stub (disabled)

6. Remote-Safe Commands

Commands available in --remote mode (before CCR init arrives). These only affect local TUI state:

session, exit, clear, help, theme, color, vim, cost, usage,
copy, btw, feedback, plan, keybindings, statusline, stickers, mobile

7. Bridge-Safe Commands

'local'-type commands safe to execute over the Remote Control bridge (from mobile/web). 'prompt' commands are always bridge-safe. 'local-jsx' commands are always blocked.

compact, clear, cost, summary, release-notes, files

8. Command Availability & Feature Flags

Availability requirements

Value	Meaning
`'claude-ai'`	Must be a claude.ai subscriber (`isClaudeAISubscriber()`)
`'console'`	Must be a first-party API user (not 3P, not claude.ai, not custom baseURL)

Commands without availability are shown to all users.

Environment variables affecting commands

Variable	Effect
`DISABLE_COMPACT`	Disables `/compact`
`DISABLE_DOCTOR_COMMAND`	Disables `/doctor`
`DISABLE_INSTALL_GITHUB_APP_COMMAND`	Disables `/install-github-app`
`DISABLE_LOGIN_COMMAND`	Disables `/login`
`DISABLE_LOGOUT_COMMAND`	Disables `/logout`
`DISABLE_FEEDBACK_COMMAND`	Disables `/feedback`
`DISABLE_BUG_COMMAND`	Disables `/feedback` alias
`DISABLE_UPGRADE_COMMAND`	Disables `/upgrade`
`DISABLE_EXTRA_USAGE_COMMAND`	Disables `/extra-usage`
`CLAUDE_CODE_USE_BEDROCK`	Disables `/feedback`
`CLAUDE_CODE_USE_VERTEX`	Disables `/feedback`
`CLAUDE_CODE_USE_FOUNDRY`	Disables `/feedback`
`USER_TYPE=ant`	Enables internal-only commands
`IS_DEMO=1`	Suppresses internal-only commands even for ant users
`CLAUDE_CODE_NEW_INIT=1`	Enables new multi-phase `/init` prompt
`CLAUDE_CODE_ENABLE_XAA=1`	Enables `--xaa` flag in `claude mcp add`
`MCP_CLIENT_SECRET`	OAuth client secret for `claude mcp add --client-secret`
`MCP_XAA_IDP_CLIENT_SECRET`	IdP client secret for `claude mcp xaa setup --client-secret`
`ULTRAPLAN_PROMPT_FILE`	Override ultraplan prompt (ant builds only)

Bun bundle feature flags

Feature flags evaluated at bundle time via feature('FLAG_NAME'):

Flag	Commands/Behavior
`BRIDGE_MODE`	Enables `/remote-control`
`BRIDGE_MODE` + `DAEMON`	Enables remoteControlServer
`KAIROS` / `KAIROS_BRIEF`	Enables `/brief`
`KAIROS`	Enables `assistant` command
`VOICE_MODE`	Enables `/voice`
`HISTORY_SNIP`	Enables `force-snip`
`WORKFLOW_SCRIPTS`	Enables `workflows` + `getWorkflowCommands`
`CCR_REMOTE_SETUP`	Enables `/web-setup`
`ULTRAPLAN`	Enables `/ultraplan`
`KAIROS_GITHUB_WEBHOOKS`	Enables `subscribe-pr`
`TORCH`	Enables `torch`
`UDS_INBOX`	Enables `peers`
`FORK_SUBAGENT`	Enables `fork` command; removes `fork` alias from `/branch`
`BUDDY`	Enables `buddy`
`PROACTIVE` / `KAIROS`	Enables `proactive`
`EXPERIMENTAL_SKILL_SEARCH`	Enables skill index cache clearing
`REACTIVE_COMPACT`	Routes `/compact` through reactive path
`CONTEXT_COLLAPSE`	Adds collapse stats to `/context` output
`NEW_INIT`	New multi-phase `/init` prompt
`BG_SESSIONS`	`/exit` detaches tmux instead of killing
`COORDINATOR_MODE`	`/clear` saves coordinator mode
`COMMIT_ATTRIBUTION`	`/clear` clears attribution caches
`TRANSCRIPT_CLASSIFIER`	`/login` runs auto-mode gate check
`DOWNLOAD_USER_SETTINGS`	`/reload-plugins` re-downloads settings in CCR mode
`MCP_SKILLS`	`getMcpSkillCommands` returns MCP prompt skills

69 KiB Raw Blame History Unescape Escape

Claude Code — Commands Reference

Table of Contents

1. Command System Architecture

Lazy Loading

2. Command Type Definitions

3. Command Registry (commands.ts)

Exports

Feature-Gated Commands

4. Individual Command Reference

/add-dir

/advisor

/agents

/ant-trace (stub)

/autofix-pr (stub)

/backfill-sessions (stub)

/branch / /fork

/break-cache (stub)

/bridge-kick

/bridge / /remote-control / /rc

/brief

/btw

/bughunter (stub)

/chrome

/clear / /reset / /new

/color

/commit

/commit-push-pr

/compact

/config / /settings

/context

/copy

/cost

createMovedToPluginCommand (utility)

/ctx_viz (stub)

/debug-tool-call (stub)

/desktop / /app

/diff

/doctor

/effort

/env (stub)

/exit / /quit

/export

/extra-usage

/fast

/feedback / /bug

/files

/good-claude (stub)

/heapdump

/help

/hooks

/ide

/init

/init-verifiers

/insights

/install-github-app

/install-slack-app

install (component)

/issue (stub)

/keybindings

/login

/logout

/mcp

/memory

/mobile / /ios / /android

/mock-limits (stub)

/model

/oauth-refresh (stub)

/onboarding (stub)

/output-style

/passes

/perf-issue (stub)

/permissions / /allowed-tools

/plan

/plugin / /plugins / /marketplace

/pr-comments

/privacy-settings

/rate-limit-options

/release-notes

/reload-plugins

69 KiB

Raw Blame History

3. Command Registry (`commands.ts`)

`/add-dir`

`/advisor`

`/agents`

`/ant-trace` (stub)

`/autofix-pr` (stub)

`/backfill-sessions` (stub)

`/branch` / `/fork`

`/break-cache` (stub)

`/bridge-kick`

`/bridge` / `/remote-control` / `/rc`

`/brief`

`/btw`

`/bughunter` (stub)

`/chrome`

`/clear` / `/reset` / `/new`

`/color`

`/commit`

`/commit-push-pr`

`/compact`

`/config` / `/settings`

`/context`

`/copy`

`/cost`

`createMovedToPluginCommand` (utility)

`/ctx_viz` (stub)

`/debug-tool-call` (stub)

`/desktop` / `/app`

`/diff`

`/doctor`

`/effort`

`/env` (stub)

`/exit` / `/quit`

`/export`

`/extra-usage`

`/fast`

`/feedback` / `/bug`

`/files`

`/good-claude` (stub)

`/heapdump`

`/help`

`/hooks`

`/ide`

`/init`

`/init-verifiers`

`/insights`

`/install-github-app`

`/install-slack-app`

`install` (component)

`/issue` (stub)

`/keybindings`

`/login`

`/logout`

`/mcp`

`/memory`

`/mobile` / `/ios` / `/android`

`/mock-limits` (stub)

`/model`

`/oauth-refresh` (stub)

`/onboarding` (stub)

`/output-style`

`/passes`

`/perf-issue` (stub)

`/permissions` / `/allowed-tools`

`/plan`

`/plugin` / `/plugins` / `/marketplace`

`/pr-comments`

`/privacy-settings`

`/rate-limit-options`

`/release-notes`

`/reload-plugins`

`/remote-env`

`/remote-setup` / `/web-setup`

`/rename`

`/reset-limits` (stub)

`/resume` / `/continue`

`/review`

`/ultrareview`

`/rewind` / `/checkpoint`