Command reference
Every sokko command and flag, with examples.
Install with npm i -g sokko (Node 18+). Run sokko --help any time.
Global options
These work on any command:
| Option | Meaning |
|---|---|
--key <key> | Use this API key instead of the stored one (or set SOKKO_API_KEY). |
--api-url <url> | Talk to a different server (default https://sokko.ai, or SOKKO_API_URL). |
--yes | Skip confirmation prompts, for scripts and CI. |
The CLI honors NO_COLOR and drops to plain output when it is not attached to a
terminal.
Account
sokko login
Validate an API key and store it at ~/.config/sokko/config.json.
sokko login
sokko login --key sk_live_xxx # non-interactivesokko logout
Remove the stored credentials.
sokko whoami
Show the organization and role you are signed in as.
Agents
sokko instances ls
List your agents with their name, runtime, status, and size.
sokko instances lssokko instances create
Create a new agent. Run it with no flags for a step-by-step prompt, or pass flags to go straight through.
sokko instances create [--runtime <r>] [--name <n>] [--byok | --sokko-credits]
[--provider <p>] [--model <id>] [--api-key <k>]
[--region us|eu] [--memory]
[--subscribe-memory monthly|annual] [--yes]| Flag | Meaning |
|---|---|
--runtime | openclaw, hermes, paperclip, or opensre. |
--name | A name for the agent. It becomes the web address https://<name>.sokko.ai. |
--byok | Bring your own key. Needs --api-key and --provider. |
--sokko-credits | Use a Sokko-managed model. Needs --model. |
--provider | For BYOK: anthropic, openai, openrouter, and others. |
--model | For Sokko credits: the model id to run. |
--api-key | For BYOK: your provider key. |
--region | us or eu. |
--memory | Turn on the memory add-on (paid; asks first). |
The machine size is set by your plan, not a flag. The CLI shows it read-only after the agent is created; change tiers from Billing in the dashboard.
sokko migrate
Bring a local agent folder into a Sokko agent — secrets, memory, and files. This one has its own page:
Migrate a local agent
The full walkthrough, including a dry run that writes nothing.
sokko migrate [--instance <id>] [--runtime <r>] [--path <dir>] [--dry-run]
[--on-conflict skip|replace] [--only secrets,memory,files]
[--create] [--subscribe-memory monthly|annual] [--yes]Running unattended
For scripts and CI, pass a key and skip prompts:
SOKKO_API_KEY=sk_live_xxx sokko instances ls
sokko migrate --instance <id> --yes --key sk_live_xxx