Shared from "Claude-Code" on Inkdown
How users interact with Claude Code and how the system is extended.
Commands are user-facing actions triggered by typing /command in the REPL.
type Command =
| { type: 'prompt', name, description, getPromptForCommand(args, context) }
| { type: 'local', name, description, action(args, context) }
| { type: 'local-jsx', name, description, action(args, context) }| Type | Behavior |
|---|---|
| prompt | Expands to a text prompt sent to the AI model |
| local | Executes locally, outputs text |
| local-jsx | Renders Ink UI components |
Commands come from multiple sources, assembled in getCommands(cwd):
All Commands = [
...bundledSkills, // Shipped with the app
...builtinPluginSkills, // From enabled built-in plugins
...skillDirCommands, // From /skills/ directories
...workflowCommands, // From workflow scripts
...pluginCommands, // From installed plugins
...pluginSkills, // Skills from plugins
...COMMANDS(), // Built-in commands
...dynamicSkills, // Discovered at runtime
]Session Management:
| Command | Type | Description |
|---|---|---|
/clear | local | Clear the conversation |
/compact | prompt | Summarize the conversation to save context |
/resume | local-jsx | Resume a previous session |
/session | local-jsx | View session info / QR code |
/rename | local | Rename the current session |
/tag | local | Add a tag to the session |
/share | local | Share the session |
/export | local | Export the conversation |
/rewind | local-jsx | Go back to a previous point |
/fork | local-jsx | Fork the conversation |
Model & Settings:
| Command | Type | Description |
|---|---|---|
/model | local-jsx | Change the AI model |
/config | local-jsx | View/edit settings |
/effort | local-jsx | Adjust effort level |
/fast | local-jsx | Toggle fast mode |
/plan | local | Toggle plan mode |
/output-style | local-jsx | Change output formatting |
/theme | local-jsx | Change terminal theme |
/color | local-jsx | Change agent color |
Tools & Extensions:
| Command | Type | Description |
|---|---|---|
/mcp | local-jsx | Manage MCP servers |
/plugin | local-jsx | Manage plugins |
/skills | local-jsx | View/manage skills |
/agents | local-jsx | Manage custom agents |
/hooks | local-jsx | View/manage hooks |
/chrome | local-jsx | Chrome integration |
Git & PRs:
| Command | Type | Description |
|---|---|---|
/diff | local | Show git diff |
/commit | local | Commit changes |
/review | prompt | Review changes |
/pr_comments | prompt | Fetch PR comments |
/branch | local-jsx | Manage branches |
/autofix-pr | prompt | Auto-fix PR issues |
Information:
| Command | Type | Description |
|---|---|---|
/help | local-jsx | Show help |
/doctor | local | Diagnose issues |
/status | local | Show session status |
/cost | local | Show session cost |
/usage | local | Show usage stats |
/stats | local | Show performance stats |
/context | local | Show context usage |
/files | local | List tracked files |
/memory | local-jsx | View/edit memory files |
/insights | prompt | Analyze sessions |
Actions:
| Command | Type | Description |
|---|---|---|
/btw | prompt | Add a side note |
/copy | local | Copy last message |
/feedback | local-jsx | Send feedback |
/good-claude | prompt | Praise Claude |
/thinkback | prompt | Reflect on the conversation |
/summary | local | Summarize conversation |
/release-notes | local | Show changelog |
Auth:
| Command | Type | Description |
|---|---|---|
/login | local-jsx | Authenticate |
/logout | local | Log out |
/permissions | local-jsx | Manage permissions |
/privacy-settings | local-jsx | Privacy settings |
Other:
| Command | Type | Description |
|---|---|---|
/vim | local | Toggle vim mode |
/keybindings | local-jsx | View keybindings |
/statusline | local | Toggle status line |
/passes | local | View pass eligibility |
/sandbox | local-jsx | Toggle sandbox |
/upgrade | local | Upgrade Claude Code |
/version | local | Show version |
/exit | local | Exit |
/env | local | Show environment variables |
/remote-env | local | Show remote environment |
/mobile | local | Show mobile QR |
/desktop | local | Desktop integration |
/ide | local | IDE integration |
/terminal-setup | local | Terminal setup |
/stickers | local | Stickers |
/advisor | local | Advisor settings |
/tasks | local-jsx | Task management |
/init | local | Initialize project |
/add-dir | local | Add directory to context |
/reload-plugins | local | Reload plugins |
/heapdump | local | Generate heap dump (debug) |
| Command | Feature Flag | Description |
|---|---|---|
/backfill-sessions | — | Backfill session data |
/break-cache | — | Debug prompt cache |
/bughunter | — | Bug hunting tool |
/commit-push-pr | — | Commit, push, and create PR |
/ctx_viz | — | Context visualization |
/good-claude | — | Internal feedback |
/issue | — | Create issue |
/init-verifiers | — | Initialize verifiers |
/force-snip | HISTORY_SNIP | Force snip compaction |
/mock-limits | — | Mock rate limits |
/bridge-kick | — | Kick bridge session |
/version | — | Show version |
/ultraplan | ULTRAPLAN | Ultraplan mode |
/subscribe-pr | KAIROS_GITHUB_WEBHOOKS | Subscribe to PR |
/reset-limits | — | Reset rate limits |
/onboarding | — | Onboarding flow |
/share | — | Share session |
/summary | — | Session summary |
/teleport | — | Teleport session |
/ant-trace | — | Debug tracing |
/perf-issue | — | Performance diagnostics |
/env | — | Environment dump |
/oauth-refresh | — | Refresh OAuth token |
/debug-tool-call | — | Debug tool calls |
/agents-platform | — | Platform agents |
/autofix-pr | — | Auto-fix PR |
When in remote mode (--remote), only these commands are available:
/session, /exit, /clear, /help, /theme, /color, /vim, /cost, /usage, /copy, /btw, /feedback, /plan, /keybindings, /statusline, /stickers, /mobile
Skills are prompt-based capabilities that extend what Claude Code can do.
A skill is a directory containing:
SKILL.md — The skill definition (markdown with frontmatter)Skills are discovered from:
src/skills/bundled/).claude/skills/ within the project~/.claude/skills/---
name: my-skill
description: What this skill does
---
# My Skill
Instructions for the AI on how to use this capability...getSkillDirCommands(cwd) walks .claude/skills/ and ~/.claude/skills/SkillTool exposes available skills to the AI modelA file watcher monitors skill directories for changes:
Plugins are versioned packages that can add tools, commands, hooks, MCP servers, and more.
Plugin Package
├── manifest.json — Plugin metadata
├── skills/ — Plugin skills
├── commands/ — Plugin commands
├── hooks/ — Plugin hooks
├── mcp/ — MCP server configs
└── versions/ — Versioned plugin codeDiscovery: Plugins are found in:
~/.claude/plugins/ (user plugins).claude/plugins/ (project plugins)--plugin-dir flag (inline plugins)Installation: claude plugin install <name>
Loading: At startup:
initBuiltinPlugins() loads bundled pluginsloadAllPlugins() discovers and loads user/project pluginsHot Reload: When settings change:
Plugins can register hooks that fire at specific events:
| Hook Event | When It Fires |
|---|---|
SessionStart | When a session starts |
SessionEnd | When a session ends |
UserPromptSubmit | Before sending user prompt to API |
AssistantResponseSubmit | Before sending assistant response to transcript |
ToolCall | When a tool is called |
Notification | When a notification is generated |
| Command | Description |
|---|---|
/plugin list | List installed plugins |
/plugin install <name> | Install a plugin |
/plugin uninstall <name> | Remove a plugin |
/plugin update <name> | Update a plugin |
/plugin search <query> | Search for plugins |
/plugin info <name> | Show plugin details |
Plugins are versioned and cached:
cleanupOrphanedPluginVersionsInBackground() removes old versions| Location | Scope |
|---|---|
~/.claude/plugins/ | User-global |
.claude/plugins/ | Project-specific |
--plugin-dir <path> | Session-specific |
| Bundled plugins | Shipped with app |
User types: /compact
│
▼
processUserInput()
│
├─ Is it a slash command?
│ ├─ Find command in command list
│ ├─ Check availability (auth requirements)
│ ├─ Check isEnabled()
│ │
│ ├─ type: 'prompt'
│ │ └─ getPromptForCommand() → send to model
│ │
│ ├─ type: 'local'
│ │ └─ action() → output text
│ │
│ └─ type: 'local-jsx'
│ └─ action() → render Ink UI
│
└─ Not a slash command
└─ Send as regular prompt to model| File | Purpose |
|---|---|
src/commands.ts | Command registry and assembly |
src/types/command.ts | Command type definitions |
src/commands/ | Command implementations (70+ commands) |
src/skills/ | Skill loading system |
src/skills/bundled/ | Bundled skills |
src/plugins/ | Plugin system |
src/plugins/bundled/ | Bundled plugins |
src/utils/plugins/ | Plugin utilities |
src/utils/skills/ | Skill utilities |
src/utils/hooks/ | Hook system |