Skip to main content

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.

CommandCategoryWhat it does
/askagentPose a question to a specific agent without delegating a task.
/attentionagentShow pending attention from the daemon (nala.escalation.pendingForHuman) grouped by category with counts.
/channelsagentShow A2A channels from the daemon (a2a.channel.list) with ids and membership.
/conductoragentMeasured 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).
/delegateagentCreate a delegation edge assigning a task to another agent.
/diffagentDisplay 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.
/inboxagentUnified attention inbox: approvals, A2A asks, failures, verification (Ctrl+I also opens it).
/orchestrateagentOpen 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 , /orchestrate (help). Aliases: /orch, /plan-goal.
/pauseagentPause one daemon scheduler run by durable run id.
/replanagentInsert a fresh planning workflow chip for the current objective — the new plan is editable before sending.
/sendagentAddress a message to a specific agent in a multi-agent session.
/worktreeagentShow 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.
/compactcontextSummarize and compact the current conversation context to reclaim token budget.
/contextcontextShow 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.
/memorycontextWould inspect session memory. This host has no memory overlay; the command refuses instead of printing a milestone id.
/tracecontextWould inspect the orchestration trace. This host has no trace overlay; the command refuses instead of printing a milestone id.
/clearnavigationClear the visible terminal buffer (does not delete session history).
/searchnavigationOpen 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.
/accountproviderAuthentication state from cached/single-flight provider probes — verified fields only.
/budgetproviderUsage and budget truth from nala.ops.usage projections. Unknown values are shown as unknown — never estimated.
/effortproviderReasoning effort lives on the launch profile. Shows the resolved profile for a provider (or the session provider) with its effort/model when reported.
/modelproviderNA-6/NA-23: list models available with first-party credentials and select one into the bound agent runtime (/model /). Host-executed in the TUI; does not require a desktop relaunch.
/profileproviderShow 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.
/providerproviderList providers or preview the verified route for a new provider launch. The bound Harmony Agent runtime is never changed cosmetically.
/routeproviderResolve the session provider route via nala.launch.resolve — the same decision the daemon makes.
/whyproviderShow 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.
/falsifyreviewInsert a workflow that reverses the claimed mutation, proves RED, restores it, and proves GREEN before acceptance.
/implementreviewInsert the implementation workflow contract into the composer as an editable chip (NTUI1-045): follow the plan, minimal change, focused verification.
/messagesreviewDisplay agent-to-agent messages, sender identity, causality, and reply targets.
/reviewreviewInsert 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.
/testreviewInsert 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 sets the scope.
/testsreviewDisplay test results, exit codes, and evidence tied to the current task.
/verifyreviewInsert 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 sets the claim.
/asidesessionAsk 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.
/attachsessionAttach this client to an existing session by id.
/btwsessionSee /aside.
/checkpointssessionList durable session checkpoints (pause snapshots) with provider, pause mode, transcript cursor, task phase, and worktree state. /checkpoints preview shows the full checkpoint contents. Restore with /rewind .
/comesessionResume the current or most recent paused session. Alias of /resume.
/detachsessionDetach this client from the current session without stopping it.
/modesessionChange the execution mode for the current session.
/newsessionStructured 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.
/recapsessionSummarize 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.
/resumesessionResume the most recent paused session, or a specific session by id.
/rewindsessionRead and validate a durable checkpoint before any mutation. /rewind previews the exact record; /rewind --confirm calls nala.session.resume and reports success only when the daemon echoes that checkpoint id with newState=active.
/sessionsessionBrowse, search, and switch between Harmony sessions. Opens the session picker overlay; see /resume for direct resume by id.
/sessionssessionList 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 filters the durable projection.
/staysessionGracefully 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.
/stopsessionCancel the in-flight agent turn for the current session.
/keymapsettingsShow the effective keymap (builtin + user layers), detect conflicts and dangling bindings, and manage user overrides: /keymap bind , /keymap unbind , /keymap reset, /keymap export. Targets are slash commands (/theme) or app actions (app.palette, app.fleet, …). User bindings shadow builtins.
/permissionssettingsShow current permission grants and pending approval requests.
/statuslinesettingsShow 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.
/themesettingsTheme gallery and control. Forms: /theme (gallery of all themes, each rendered in its own palette), /theme or /theme set (select a theme, persisted to general.theme), /theme preview (live preview without committing), /theme commit | /theme cancel (keep or revert a preview), /theme lint (WCAG contrast diagnostics). Themes: nala-obsidian, nala-paper, nala-hc-dark, nala-hc-light, terminal-native, monochrome.
/usagesettingsWould show token / cost usage. This host has no usage overlay; the command refuses instead of printing a milestone id.
/bannersystemRe-display the Harmony wordmark, or toggle banner display on startup. Use /banner on or /banner off to change the startup setting.
/debugsystemAssemble 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] writes the bundle to a safe text file after showing the summary.
/doctorsystemRun an actionable diagnostic sweep: terminal capabilities, theme contrast, keymap conflicts, command registry, brand integrity, and daemon connection. Every failing check prints its exact remediation.
/inspectsystemShow 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.
/quitsystemDetach all sessions and exit the Harmony TUI or Desktop application.
/artifacttaskList artifacts produced in the current session and export or open them.
/backgroundtaskTasks currently running in the background from nala.task.list.
/exporttaskRequest 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.
/finishtaskAsk the daemon verification gate whether a task can complete, then perform the canonical task transition. Usage: /finish .
/plantaskInsert 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 sets the objective.
/tasktaskManage tasks within the current workspace.
/extensionstoolsWould list extensions. This host has no extensions overlay; the command refuses instead of printing a milestone id.
/mcptoolsWould inspect MCP servers and tools. This host has no MCP overlay; the command refuses instead of printing a milestone id.
/pluginstoolsPackage manager with visible trust and code-execution implications. Forms: /plugins (list installed packages with trust class and state), /plugins inspect (capabilities, network, scripts, native binaries, signature, hash), /plugins enable|disable , /plugins quarantine (list quarantined packages).
/sandboxtoolsSandbox 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.
/toolstoolsAlias for /mcp. This host has no MCP overlay.
/barkvoiceSubmit 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 , or include /bark anywhere in a normal prompt. Brief 2–3 sentence conversational style.
/play-backvoiceWould 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 | | pause | resume | stop | list | delete | clear --session]. Aliases: /pb, /playback.
/read-aloudvoiceSubmit a prompt and read a spoken summary aloud, or control the read-aloud session mode. Forms: /read-aloud , /read-aloud on, /read-aloud off, /read-aloud status, /read-aloud (bare = help). Aliases: /ra.
/speakvoiceControl spoken output of agent responses. Subcommands: on (enable TTS), off (disable TTS), last (speak last response), stop (stop current speech).
/voicevoiceControl microphone voice input. Subcommands: start (begin dictation), stop (end dictation), cancel (abort), settings (open voice settings).