CLI reference

The nala command is the scriptable counterpart to the desktop, attached to the same daemon. Legacy wmux commands remain available; both shims are installed on your PATH.

Core

nala                                 Open the interactive TUI
nala "initial prompt"                Open the TUI with an initial prompt
nala run "prompt" [options]          Run a noninteractive task
nala ask "prompt"                    Ask a question (ask mode)
nala plan "prompt"                   Plan-mode execution
nala sit                             Launch or focus nala desktop (alias: nala desktop)
nala desktop [--attach <sessionId>]  Open or focus nala desktop
nala update [--check]                Check for and install updates
nala version                         Print version information
nala help [command]                  Show help
nala doctor [--json] [--fix-safe]    Run health diagnostics

Daemon management

nala daemon start                    Start the daemon
nala daemon status                   Show daemon status
nala daemon logs                     Show recent daemon logs
nala daemon restart                  Restart the daemon
nala daemon stop                     Stop the daemon (refuses if work is active)

Sessions

nala sessions list                   List all sessions
nala sessions show <id>              Show session details
nala sessions attach-metadata <id>   Show attachment metadata
nala sessions archive <id>           Archive a session
nala attach <sessionId>              Attach to an existing session
nala resume <sessionId>              Resume a paused session

Providers

nala providers list                  List available providers
nala providers probe <name>          Probe a specific provider
nala providers status                Show provider authentication status

Tasks, agents, artifacts

nala tasks list|create|close         Manage tasks
nala agents list                     List and manage agents
nala artifacts list|export           Inspect session artifacts
wmux nala agent send --task <taskId> --to <agentId> --message "ready" --from <agentId>
wmux nala agent inbox --agent <agentId> --unread
wmux nala provider settings --yolo-on --a2a connect
wmux nala capabilities               List supported RPC methods
wmux nala diagnostics --json         Machine-readable diagnostics

Channels

wmux channel list                    Channels visible to your workspace
wmux channel join <ch>               Join a public channel
wmux channel post <ch> <text…>       Post a message
wmux channel read <ch> [--since <seq>]  Print messages, oldest first
wmux channel unread [--member <id>]  Unread + mention counts
wmux channel ack <ch> <uptoSeq|all>  Mark consumed

Workspaces, panes, browser

wmux list-workspaces                 List all workspaces
wmux new-workspace [--name <name>] [--cwd <dir>]
wmux focus-workspace <id>
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 <text> [--submit]          Send text to your own pane
wmux send-key <keystroke>            Send a key (Enter, ctrl-c, Tab)
wmux read-screen [--tail <n>]        Read the current screen
wmux open <url> [--workspace <id>]   Open/reuse a browser pane
wmux browser navigate <url>
wmux browser session start [--profile <name>]
wmux browser close

Voice

nala speak "text"                    System TTS, desktop closed
nala dictate --wav recording.wav     Local faster-whisper transcription
nala voice status                    Voice subsystem status

Configuration, MCP, observability

nala config get [key]                Read configuration
nala config set <key> <value>        Set a value
nala config unset <key>              Remove a value
nala config path                     Show the config file path
nala 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
nala trace tail                      Tail the event trace stream
nala trace export [--format json|jsonl]

Notes

• Piped and scripted output is machine-readable; the launch banner never appears in noninteractive output.
• nala 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.