Nanoclaw CLI

Everything the app does, from your terminal.

Install with Homebrew (or build from source) and you have a single binary that starts agents, routes messages, runs the MCP server, and controls a running fleet.

Install

bash

brew install tmc/tap/nanoclaw

Or build from source:

bash

go install github.com/tmc/nanoclaw@latest

Five commands you'll use constantly

Start the host process

bash

nanoclaw serve

Registers your machine as a fleet host, starts the platform adapters (WhatsApp, Discord, etc.), and begins routing messages to agent VMs. Runs until you stop it.

Create and start an agent

bash

nanoclaw launch --agent my-agent --tier specialist # legacy flag for profile selection

Boots a new agent VM, connects it to the current group, and returns when it's running.

Send a message or prompt to an agent

bash

nanoclaw send "summarize the last week of activity"
nanoclaw send --agent researcher "find papers on FPE tokenization"

Delivers the text to the default agent or a named agent. Streams the response to stdout.

Control a running host

bash

nanoclaw ctl reload-agents   # hot-reload agent definitions
nanoclaw ctl status          # show running agents and resource usage
nanoclaw ctl rebuild         # rebuild and restart all agents

nanoclaw ctl connects to the running nanoclaw serve process over a Unix socket.

Run the MCP server

bash

nanoclaw mcp

Starts the MCP stdio server, which Claude uses to call nanoclaw tools — send_message, schedule_task, delegate_task, and the rest. You don't usually run this directly; the agent VM starts it automatically.

Other commands

Command	What it does
`nanoclaw init`	Initialize a new workspace
`nanoclaw login`	Authenticate with the ncd control plane
`nanoclaw exec`	Execute a one-shot agent task and exit
`nanoclaw doctor`	Check your environment for issues
`nanoclaw proxy`	Start the Envoy intercepting proxy
`nanoclaw vpods`	Manage VPod microVM groups
`nanoclaw dev-host`	Run a development host (no cloud required)
`nanoclaw export-sessions`	Export Claude session history
`nanoclaw mine-signals`	Mine security signals from session history

Tip: default agent

Any text that isn't a subcommand is treated as a message to send:

bash

nanoclaw "what's on my calendar today?"

Equivalent to nanoclaw send "what's on my calendar today?".

Full reference

See the CLI reference → for every flag and option.