CLI reference
Every nala and wmux command, grouped: core, daemon, sessions, providers, tasks, channels, browser, and diagnostics.
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-saferepairs the safe class of problems (paths, shims, registration) automatically.- Workspace identity is required for channel and agent mutations: outside a nala pane they fail closed.