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. |