TUI slash commands
PreviewAvailable on: WindowsShips in the preview channel only. Not a stable release.
Every slash command registered by the Harmony TUI, generated from the command registry.
Generated from src/tui/slash-commands/builtin-commands.ts at Harmony 3.24.33-preview.5. 74 commands are registered.
Type / in the composer to open the command list. Commands are the only way to change mode, switch route, or reach an overlay without leaving the keyboard.
| Command | Category | What it does |
|---|---|---|
/ask | agent | Pose a question to a specific agent without delegating a task. |
/attention | agent | Show pending attention from the daemon (nala.escalation.pendingForHuman) grouped by category with counts. |
/channels | agent | Show A2A channels from the daemon (a2a.channel.list) with ids and membership. |
/conductor | agent | Measured leader controls: status, reassign, falsify, route, reconcile, gate, or resume. Fleet truth always comes from GHOST-8 stamps via M89-1 decideWorkerActivityBelief (never screen scrape). |
/delegate | agent | Create a delegation edge assigning a task to another agent. |
/diff | agent | Display the uncommitted diff for the current worktree: stat summary then the patch (first 400 lines, path-redacted, colored +/-). Reads local git read-only — the daemon worktree.diff RPC does not exist yet; when it lands, this switches loaders. |
/inbox | agent | Unified attention inbox: approvals, A2A asks, failures, verification (Ctrl+I also opens it). |
/orchestrate | agent | Open the Harmony Agent orchestrator for a goal: propose steps, choose a model per step WITH a plain-language reason and evidence, show projected cost and billing route before consent (blocks if unknown), then run under one scoped consent. Optional path — Pro manual workflow remains first-class. Forms: /orchestrate |
/pause | agent | Pause one daemon scheduler run by durable run id. |
/replan | agent | Insert a fresh planning workflow chip for the current objective — the new plan is editable before sending. |
/send | agent | Address a message to a specific agent in a multi-agent session. |
/worktree | agent | Show worktrees from the daemon (nala.worktree.list) with lease holder and status. /worktree status shows the current workspace git state (nala.worktree.status). Creation and teardown are daemon-governed operations performed in Desktop. |
/compact | context | Summarize and compact the current conversation context to reclaim token budget. |
/context | context | Show a deterministic context breakdown from the session event stream: bytes and event counts per category (assistant, user, tool results, files/diffs, artifacts, a2a, reasoning, system). Token budget and provider-side context are marked unknown unless the daemon reports them — never estimated. |
/memory | context | Would inspect session memory. This host has no memory overlay; the command refuses instead of printing a milestone id. |
/trace | context | Would inspect the orchestration trace. This host has no trace overlay; the command refuses instead of printing a milestone id. |
/clear | navigation | Clear the visible terminal buffer (does not delete session history). |
/search | navigation | Open the transcript search overlay: results carry section and turn attribution with the query highlighted in the transcript; up/down cycle matches; Enter jumps exactly to the selected match. Covers message text, tools, files, and errors. Ctrl+F also opens it. |
/account | provider | Authentication state from cached/single-flight provider probes — verified fields only. |
/budget | provider | Usage and budget truth from nala.ops.usage projections. Unknown values are shown as unknown — never estimated. |
/effort | provider | Reasoning effort lives on the launch profile. Shows the resolved profile for a provider (or the session provider) with its effort/model when reported. |
/model | provider | NA-6/NA-23: list models available with first-party credentials and select one into the bound agent runtime (/model |
/profile | provider | Show launch profiles from the daemon (nala.launch.profiles): profile id, route, model, permission policy, and which provider uses each by default. Profile changes are made in Desktop or via nala.launch.profile.upsert. |
/provider | provider | List providers or preview the verified route for a new provider launch. The bound Harmony Agent runtime is never changed cosmetically. |
/route | provider | Resolve the session provider route via nala.launch.resolve — the same decision the daemon makes. |
/why | provider | Show the source-backed reason for the current execution route: the resolved launch plan (route, profile, wrapped style, health), whether a route choice is required, and the alternatives that were available. Uses nala.launch.resolve — the same decision the daemon makes — never inferred state. |
/falsify | review | Insert a workflow that reverses the claimed mutation, proves RED, restores it, and proves GREEN before acceptance. |
/implement | review | Insert the implementation workflow contract into the composer as an editable chip (NTUI1-045): follow the plan, minimal change, focused verification. |
/messages | review | Display agent-to-agent messages, sender identity, causality, and reply targets. |
/review | review | Insert the review workflow contract into the composer as an editable chip (NTUI1-045): correctness, risk, regressions, security, and coverage with file:line evidence. Edit it, then Enter to send. /review diff|file|commit sets the target. |
/test | review | Insert the test workflow contract into the composer as an editable chip (NTUI1-045): focused subset, exit codes, failure diagnosis with evidence, minimal proposed fixes. /test |
/tests | review | Display test results, exit codes, and evidence tied to the current task. |
/verify | review | Insert the verification workflow contract into the composer as an editable chip (NTUI1-045): independent end-to-end verification with commands, outputs, and states checked; verified only with evidence. /verify |
/aside | session | Ask a question in an ephemeral session that sees the main session context but uses no tools and never alters the main conversation (NTUI1-030). Works while the main turn runs. The answer can be promoted into the main thread explicitly. Alias: /btw. |
/attach | session | Attach this client to an existing session by id. |
/btw | session | See /aside. |
/checkpoints | session | List durable session checkpoints (pause snapshots) with provider, pause mode, transcript cursor, task phase, and worktree state. /checkpoints preview |
/come | session | Resume the current or most recent paused session. Alias of /resume. |
/detach | session | Detach this client from the current session without stopping it. |
/mode | session | Change the execution mode for the current session. |
/new | session | Structured Harmony Agent session create is unavailable until a supervised Pi SDK AgentSession is proven (Prompt 0J). Use a certified direct-PTY provider launch for live agents. |
/recap | session | Summarize the current session from the typed event stream: turns, tool usage, files changed, approvals, errors, artifacts, A2A, time span, and the last assistant line. Purely factual — never generated by a model. |
/resume | session | Resume the most recent paused session, or a specific session by id. |
/rewind | session | Read and validate a durable checkpoint before any mutation. /rewind |
/session | session | Browse, search, and switch between Harmony sessions. Opens the session picker overlay; see /resume for direct resume by id. |
/sessions | session | List sessions from the daemon with state, provider, title, and lineage. Missing parent/root facts render as lineage UNKNOWN; list order is never treated as ancestry. /sessions |
/stay | session | Gracefully pause the current Harmony Agent session. Stops new turns, persists a checkpoint, and transitions to paused state. The provider must never receive /stay as a prompt unless escaped. |
/stop | session | Cancel the in-flight agent turn for the current session. |
/keymap | settings | Show the effective keymap (builtin + user layers), detect conflicts and dangling bindings, and manage user overrides: /keymap bind |
/permissions | settings | Show current permission grants and pending approval requests. |
/statusline | settings | Show the active status-line modules, or set them: /statusline set activity,mode,model,context. Modules: activity, mode, workspace, branch, task, provider, account, model, effort, billing, permission, sandbox, context, cost, agents, attention, connection. |
/theme | settings | Theme gallery and control. Forms: /theme (gallery of all themes, each rendered in its own palette), /theme |
/usage | settings | Would show token / cost usage. This host has no usage overlay; the command refuses instead of printing a milestone id. |
/banner | system | Re-display the Harmony wordmark, or toggle banner display on startup. Use /banner on or /banner off to change the startup setting. |
/debug | system | Assemble a support bundle (inspect report, doctor sweep) with secret redaction applied. Transcript is omitted unless --include-transcript. The redaction count and sections are shown before anything is exported. /debug write [--overwrite] [--include-transcript] |
/doctor | system | Run an actionable diagnostic sweep: terminal capabilities, theme contrast, keymap conflicts, command registry, brand integrity, and daemon connection. Every failing check prints its exact remediation. |
/inspect | system | Show exactly what is running and why: Harmony/Pi/Node versions, daemon handshake, workspace and provider, active theme and its source, command registry stats, declared keybindings and conflicts, terminal capabilities, and brand integrity hashes. /inspect json emits the machine-readable form of the same report. |
/quit | system | Detach all sessions and exit the Harmony TUI or Desktop application. |
/artifact | task | List artifacts produced in the current session and export or open them. |
/background | task | Tasks currently running in the background from nala.task.list. |
/export | task | Request the current session transcript from the daemon and show its verified format, event count, byte count, and bounded preview. The default command does not claim that a file or clipboard write occurred. |
/finish | task | Ask the daemon verification gate whether a task can complete, then perform the canonical task transition. Usage: /finish |
/plan | task | Insert the planning workflow contract into the composer as an editable chip (NTUI1-045): objective, scope boundaries, steps with verification, risks, and a review checkpoint before implementation. Edit it, then Enter to send. /plan |
/task | task | Manage tasks within the current workspace. |
/extensions | tools | Would list extensions. This host has no extensions overlay; the command refuses instead of printing a milestone id. |
/mcp | tools | Would inspect MCP servers and tools. This host has no MCP overlay; the command refuses instead of printing a milestone id. |
/plugins | tools | Package manager with visible trust and code-execution implications. Forms: /plugins (list installed packages with trust class and state), /plugins inspect |
/sandbox | tools | Sandbox truth: the daemon BoundaryEnforcer filters spawn environments and validates exec. This build exposes no runtime sandbox RPC — the profile is enforced, not configurable from the TUI. |
/tools | tools | Alias for /mcp. This host has no MCP overlay. |
/bark | voice | Submit a prompt and get a short plain-English spoken summary when the agent finishes. Audio is pre-synthesized so it is ready at the end of the run; press Enter to play. Forms: /bark |
/play-back | voice | Would play back clips from the session audio library. No playback engine or clip store is attached to this host, so the control verbs report that instead of claiming the deed (E08-002). Clips live in the desktop read-aloud session that made them. Forms: /play-back [last | |
/read-aloud | voice | Submit a prompt and read a spoken summary aloud, or control the read-aloud session mode. Forms: /read-aloud |
/speak | voice | Control spoken output of agent responses. Subcommands: on (enable TTS), off (disable TTS), last (speak last response), stop (stop current speech). |
/voice | voice | Control microphone voice input. Subcommands: start (begin dictation), stop (end dictation), cancel (abort), settings (open voice settings). |