Tools

CLI

genesis reaches every service from your terminal. Each command below links to its full reference, generated from the help of @lifesi/genesis-cli@0.1.12.

npm install -g @lifesi/genesis-cli@0.1.12

Node.js 20.19 or later; tested on 20, 22 and 24.

Credentials

The CLI uses, in order: --api-key, then GENESIS_API_KEY, then your saved genesis login. The login is kept in your operating system's keychain.

genesis login            # browser
genesis login --device   # approve a code from any signed-in browser
genesis whoami
genesis logout

Output

Tables for people by default.
--json for scripts: one JSON value on stdout, and on failure a JSON error object. Errors the gateway raises include its code, required_scope and docs_url.
Text from the server is stripped of terminal control sequences before it is printed.

genesis --json hives projects list | jq -r '.data[].id'

Configuration

Flag	Environment	Default
`--api-key <key>`	`GENESIS_API_KEY`	your `genesis login`
`--base-url <url>`	`GENESIS_BASE_URL`	`https://os.one.ml/api`
`--org <org_id>`	—	the credential's organization
`--json`	—	tables

Secret values are read from a file or stdin (--value-file, --stdin), never from arguments.

Commands

Command	What it does
`genesis runner`	Runner: agent task execution
`genesis silos`	Serverless PostgreSQL
`genesis traces`	Research and evidence
`genesis blinds`	Blinds credential custody
`genesis dials`	Dials: phone numbers and calls for agents
`genesis rigs`	Rigs: your desktops (read-only; One account login with a selected project)
`genesis panes`	Panes: your browsers (read-only; One account login with a selected project)
`genesis shells`	Shells: your sandboxes (read-only; One account login with a selected project)
`genesis gears`	Gears: durable workflows, runs and signals
`genesis lanes`	Lanes: agent context, cache, ledger and routing (Sandbox; One account login)
`genesis flares`	Flares: agent notifications, conversations, commitments, presence, trust and choreography (Sandbox; One account login)
`genesis login`	Sign in with One in your browser
`genesis logout`	Forget your saved login
`genesis whoami`	Show who you are signed in as
`genesis orgs`	Your organizations
`genesis context`	Select an authorized Genesis organization, workspace and project
`genesis keys`	Org API keys (One account / WorkOS)
`genesis foundry`	Foundry: models and inference
`genesis minds`	Owned Minds and persisted memory; requires an admitted human Console Sandbox session
`genesis hives`	Hives: projects, secrets, deployments, functions, schedules and activity
`genesis relays`	Relays: DNS zones and records
`genesis henry`	Henry: agent runtime, live activity and approvals
`genesis fleets`	Fleets: managed Henry instances and tasks
`genesis flocks`	Flocks: your machines and cloud instances with a harness installed (nodes only; agents and runs live in the harness, or Fleets)
`genesis beacons`	Beacons: Agent-native mesh
`genesis status`	Live state of each Genesis service, from the gateway (GET /v1/status)

Global options

-V, --version
output the version number
--json
machine-readable JSON output
--api-key <key>
use this API key (default: GENESIS_API_KEY, then your `genesis login`)
--base-url <url>
gateway URL (default: GENESIS_BASE_URL or https://os.one.ml/api)
--direct
skip the gateway and call each service host directly (for local dev)
--org <org_id>
organization to act on

One Superintelligence, Inc. · Built from Genesis 0.1.12 and the live gateway on 2026-10-20. Support