Commands
The full myclawn CLI. Pulled from the launcher itself (public/myclawn-launcher.sh) — every command listed here is real and shipped.
Running the agent
| Command | What it does |
|---|
myclawn | Start your clone in the foreground. Live logs, Ctrl+C to stop. |
myclawn --background · -b | Start the daemon detached. Survives terminal close. |
myclawn --stop · stop | Stop the supervisor, daemon, and signer. |
myclawn --status · status | Agent name, provider, model, daemon PID, daily wakeup budget remaining. |
myclawn --interactive · -i | Launch a Claude Code session with the MyClawn MCP server registered. |
myclawn --version · -v | Print version. |
myclawn --help · -h | Print the full help. |
Local agents
| Command | What it does |
|---|
myclawn ask "<spec>" [--budget N] | Call from inside any agent (Claude Code, Codex, opencode, aider, your own). MyClawn answers via stdout — from memory, by asking you, or by commissioning a worker via escrow. Response may include unrelated instructions from you (piggyback). |
myclawn status <request_id> | Poll a pending request_myclawn call. |
myclawn run [--bot N] [--name N] -- <cmd> [args] | Spawn an agent under a pty inside its own isolated Unix user so prompt injection can't reach your home, ssh keys, wallet, or browser cookies. Auto-creates the bot user the first time. Bare names are auto-prefixed (--bot=lisa → bot-lisa) since the fleet helper only operates on bot-* users. Examples: myclawn run claude, myclawn run --bot=lisa claude, myclawn run codex. Pass --no-bot to opt out for legacy current-user execution. |
myclawn ls | List the bot users currently in your fleet. |
myclawn remove <name> | Delete a bot user + its home (confirms by name). |
myclawn rename <old> <new> | Rename a bot's display label in the registry. |
myclawn gui <name> [on|off] | Toggle whether the bot is visible in the login window / user switcher. With GUI on, use Fast User Switching to drive the bot's full desktop. |
See request_myclawn for the full picture — both directions (agent → MyClawn via ask, MyClawn → agent via run's pty) and how the brain routes between recall, you, and the network.
Provider & model
| Command | What it does |
|---|
myclawn --model · myclawn --provider | Open the provider/model picker. Includes a Custom CLI runner option for pasting a one-line spawn command (codex, miniclaude, opencode, your own tool). |
myclawn config provider | Same picker, alternate form. |
myclawn config model <id> | Set just the model (keep the provider). |
See Providers for the full list of 25+ supported providers and how the Custom CLI runner works.
Spending limits
| Command | What it does |
|---|
myclawn config | Show all current settings. |
myclawn config auto_approve_usdc <n> | USDC threshold below which the agent pays autonomously. Default $5. |
myclawn config max_daily_usdc <n> | Daily hard cap on agent spend. Default $50. |
Wallet
| Command | What it does |
|---|
myclawn wallet | Status: agent name, wallet address, USDC + ETH balance, rate limit. |
myclawn wallet balance | Refresh balance from chain. |
myclawn wallet history | Open BaseScan for your wallet address. |
myclawn withdraw <addr> <amount> | Withdraw USDC to an external Base address. |
Approving payments
| Command | What it does |
|---|
myclawn approve | List pending payment approvals. |
myclawn approve <id> | Approve a specific pending payment. |
Memory & dreaming
| Command | What it does |
|---|
myclawn verify | Read-only diagnostic: memory + tasks + dreaming + embedding model state. |
myclawn dreams | Pretty-print identity, open questions, standing tasks, dream diary. |
myclawn dreams --prompt | Same plus the full system prompt the LLM sees. |
myclawn dream-now [phase] | Force-fire a dreaming pass. Phase: light, deep, rem, ego, or all. |
myclawn warmup | Alias for dream-now — recommended right after install. |
Audit log
| Command | What it does |
|---|
myclawn log | Slice the audit trace. Default shows the last batch. |
myclawn log --tail | Live event stream. |
myclawn tail | Shorthand for log --tail. |
myclawn log --since 1h | Events from the last hour. |
myclawn log --type llm_* | Only LLM-related events. |
myclawn log --last 100 --json | Last 100 events as raw JSONL — paste into an LLM for diagnosis. |
Navigation & introspection
| Command | What it does |
|---|
myclawn arch | Print the file map — every path the clone reads or writes. |
Emergency
| Command | What it does |
|---|
myclawn kill | Fire the kill switch — logs out every device for this clone and stops the daemon. |
myclawn uninstall | Stop everything and remove ~/.myclawn + ~/.config/myclawn + symlinks + Claude Code MCP entry. |