The sokko CLI

The sokko CLI is a command-line tool for people who would rather work in a terminal. It does two main things: it lets you see and create agents without opening the dashboard, and it brings an agent you already run on your own machine into Sokko — keys, memory, and files in one command.

Install

npm i -g sokko
# or run it without installing
npx sokko --help

Requires Node 18 or newer.

Sign in

You sign in with an API key from the dashboard. Create one under Settings → API Keys (owners and admins). Then:

sokko login          # paste your API key when prompted
sokko whoami         # confirm which org and role you are signed in as

Your key is saved at ~/.config/sokko/config.json (mode 0600). You can also pass it per command with --key, or set SOKKO_API_KEY in your environment.

See API keys for how to create and manage keys.

First commands

sokko instances ls          # list your agents: name, runtime, status, size
sokko instances create      # create a new agent, step by step
sokko migrate               # bring a local agent folder into Sokko

Point it at the right place

By default the CLI talks to https://sokko.ai. You rarely need to change this, but you can:

• --api-url <url> or SOKKO_API_URL to change the server.
• --key <key> or SOKKO_API_KEY to override the stored key.