# CLI reference Source: https://docs.ideharmony.com/cli The `harmony` command is the scriptable counterpart to the desktop, attached to the same daemon. **`harmony` and `nala` are the same command.** `harmony` is the name to learn; `nala` is the original name for the same binary and still works everywhere — same verbs, same behaviour, no deprecation. Every command on this page is valid under either name. `wmux` is a third name on the same binary, but it is **not** an alias: it is the original multiplexer surface, and the workspace, pane and input verbs live there. All three shims are installed on your PATH. Two shorthands worth knowing: - `harmony` — launch the agent in the current terminal - `harmony .` — open the current directory as a workspace in the desktop app (any path works: `harmony ../other-project`) ## Core ```bash harmony Open the interactive TUI harmony tui Open the interactive TUI explicitly harmony "prompt" Run one Harmony Agent turn and print the transcript harmony run "prompt" [options] Run one Harmony Agent turn headlessly (scripts, CI) harmony ask "prompt" Refused for now (exit 8): read-only turns cannot be enforced yet harmony plan "prompt" Refused for now (exit 8): planning-only turns cannot be enforced yet harmony sit Launch or focus Harmony Desktop (alias: harmony desktop) harmony desktop [--attach ] Open or focus Harmony Desktop desktop harmony update [--check] Check for and install updates harmony version Print version information harmony help [command] Show help harmony doctor [--json] [--fix-safe] Run health diagnostics ``` ## Daemon management ```bash harmony daemon start Start the daemon harmony daemon status Show daemon status harmony daemon logs Show recent daemon logs harmony daemon restart Restart the daemon harmony daemon stop Stop the daemon (refuses if work is active) ``` ## Sessions ```bash harmony sessions list List all sessions harmony sessions show Show session details harmony sessions attach-metadata Show attachment metadata harmony sessions archive Archive a session harmony attach Attach to an existing session harmony resume Resume a paused session ``` ## Providers ```bash harmony providers list List available providers harmony providers probe Probe a specific provider harmony providers status Show provider authentication status ``` ## Tasks, agents, artifacts ```bash harmony tasks list|create|close Manage tasks harmony agents list List and manage agents harmony artifacts list|export Inspect session artifacts harmony agent send --task --to --message "ready" --from harmony agent inbox --agent --unread harmony provider settings --yolo-on --a2a connect harmony capabilities List supported RPC methods harmony diagnostics --json Machine-readable diagnostics ``` ## Channels ```bash wmux channel list Channels visible to your workspace wmux channel join Join a public channel wmux channel post Post a message wmux channel read [--since ] Print messages, oldest first wmux channel unread [--member ] Unread + mention counts wmux channel ack Mark consumed ``` ## Workspaces, panes, browser ```bash wmux list-workspaces List all workspaces wmux new-workspace [--name ] [--cwd ] wmux focus-workspace wmux current-workspace wmux new-surface Open a new surface (terminal tab) wmux list-panes List panes in the active workspace wmux split [--direction right|down] wmux send [--submit] Send text to your own pane wmux send-key Send a key (Enter, ctrl-c, Tab) wmux read-screen [--tail ] Read the current screen wmux open [--workspace ] Open/reuse a browser pane wmux browser navigate wmux browser session start [--profile ] wmux browser close ``` ## Voice ```bash harmony speak "text" System TTS, desktop closed harmony dictate --wav recording.wav Local faster-whisper transcription harmony voice status Voice subsystem status ``` ## Configuration, MCP, observability ```bash harmony config get [key] Read configuration harmony config set Set a value harmony config unset Remove a value harmony config path Show the config file path harmony config validate Validate the config file wmux mcp check Show MCP registration status wmux mcp register Register nala with ~/.claude.json wmux mcp unregister Remove registration wmux setup-hooks Install Claude Code hooks harmony trace tail Tail the event trace stream harmony trace export [--format json|jsonl] ``` ## Notes - Piped and scripted output is machine-readable; the launch banner never appears in noninteractive output. - `harmony run` options, output schema and exit codes are on [Headless runs](/docs/cli/run). - `harmony doctor --fix-safe` repairs the safe class of problems (paths, shims, registration) automatically. - Workspace identity is required for channel and agent mutations: outside a Harmony pane they fail closed.