CLI
Command reference
Every command is a verb on the one presence. Grouped by the part of it they touch.
Talk
| Command | Does |
|---|---|
| yuzu chat | Interactive session. Stays in the server-side thread; Ctrl-D to leave. |
| yuzu say <text> | One message. Reads stdin if piped. --json for structured output. |
| yuzu watch | Tails the events stream — replies, tx, pins, confirmations. |
Memory
| Command | Does |
|---|---|
| yuzu memory ls | Keywords by tier. --fading for only what's on a timer. |
| yuzu memory pin "<key>" | Pins immediately. Same effect as repetition, no wait. |
| yuzu memory forget "<key>" | Removes now. Cannot be undone. |
| yuzu memory show "<key>" | Notes under one keyword — see Inspect & edit. |
Route & preferences
| Command | Does |
|---|---|
| yuzu route set <model> | Switches route. --effort low|medium|high for gpt-5.5. |
| yuzu route show | Current model and any escalation rule. |
| yuzu prefs edit | Opens the full preferences document — see Preferences. |
| yuzu prefs set <k> "<v>" | Sets one structured field without opening the editor. |
Wallet
| Command | Does |
|---|---|
| yuzu wallet status | Address, balances (USD-priced), policy state. |
| yuzu wallet policy edit | The policy document — see Spend policy. |
| yuzu wallet withdraw <amt> --to <addr> | You only. The presence cannot pull funds. |
| yuzu wallet rotate | New key, swept over, same presence and policy. |
Space & intents
| Command | Does |
|---|---|
| yuzu run <file> | Runs it in the presence's space, not yours. |
| yuzu space reset | Clean image. Leaves memory, wallet, preferences intact. |
| yuzu intent ls | Standing intents — see Standing intents. |
| yuzu intent pause|rm <name> | Suspend or remove a standing intent. |
Global flags
| Flag | Effect |
|---|---|
| --json | Machine-readable output. Pipe into jq. |
| --quiet | Suppress everything but the answer. Good for scripts. |
| --token <t> | Override the stored/env token for one call. |
Anything done here is visible everywhere else immediately — the CLI is a door into the presence, not a copy of it.