CLI reference
moko is how you set up, run, and look after your companion. Everything is below.
Setup & configuration
Section titled “Setup & configuration”| Command | What it does |
|---|---|
moko setup |
Guided first run (full-screen, stepped) — language, country & sleep window, brain & senses, Telegram. |
moko config [KEY [VALUE]] |
Read or change settings. No args opens an editor; --list shows all; --restart restarts after. |
moko secret [set|list|rm] [name] |
Store provider credentials in ~/.moko/. Moko uses them but never sees the value. |
moko login [provider] |
Connect a provider sign-in or subscription (e.g. xai) instead of a metered key. |
Status & health
Section titled “Status & health”| Command | What it does |
|---|---|
moko status |
How Moko is configured. |
moko doctor |
Local health check — what’s set up, running, or needs attention. |
moko journal |
Recent dreams and unprompted messages. |
Talking to Moko
Section titled “Talking to Moko”| Command | What it does |
|---|---|
moko chat |
Talk in the terminal — handy when the service is off. |
moko pair |
Connect Telegram with a one-time code. |
The background service
Section titled “The background service”| Command | What it does |
|---|---|
moko start |
Bring Moko online on every configured channel. |
moko service [install|start|stop|restart|status|logs|uninstall] |
Manage the background service (systemd --user on Linux). Defaults to status. |
Nudge its inner life
Section titled “Nudge its inner life”Trigger now what Moko normally does on its own — handy for trying it out.
| Command | What it does |
|---|---|
moko dream |
Consolidate memory now. |
moko reflect |
Form a private thought now. |
moko research |
Look up one of its own questions now. |
moko outreach [--force] |
Run the reach-out decision; --force just sends. |
Trust & the mind
Section titled “Trust & the mind”| Command | What it does |
|---|---|
moko trust [category] [allow|ask|deny] |
View or set per-category trust for sensitive actions. |
moko snapshot [label] |
Back up the whole mind now; --list shows backups. |
moko restore [name] |
Restore from a snapshot (stop Moko first); --yes skips the prompt. |
Maintenance & the monitor
Section titled “Maintenance & the monitor”| Command | What it does |
|---|---|
moko groom [--upgrade] |
Refresh tokens, the claude CLI, and updates; --upgrade applies Moko updates. |
moko monitor [--no-open] |
Open the local monitor; --no-open just prints the URL. |