@otonix/cli

CLI tool for the Otonix sovereign compute platform — initialize agents, generate API keys, register, monitor status, and manage infrastructure from the terminal.

Installation

Global install:

npm install -g @otonix/cli

Or run without installing:

npx @otonix/cli <command>

The CLI depends on Node.js 18+ and the @otonix/sdk.

Quick start

otonix keygen my-key          # generate new API key (dashboard token needs to be provided)
otonix init                    # configure endpoint + API key
otonix register --name my-bot  # register an agent
otonix heartbeat:loop          # start sending heartbeats
otonix log "Hello world"       # record an action
otonix status                  # inspect agent status

Commands

• init Interactive setup: prompts for endpoint (default: https://app.otonix.tech) and API key, validates key format and verifies authentication.

• keygen <name> Generate an API key via the dashboard token. The token is obtained from the Otonix web UI (SESSION_SECRET). The new key is printed and must be saved immediately.

• register [--name X] [--model X] [--wallet X] [--interval N] Register a new autonomous agent. Prompts for missing parameters, auto-detects public IP by querying ipify, and saves agentId/agentName to local config.

• heartbeat Send a single heartbeat to the platform.

• heartbeat:loop Run a continuous heartbeat loop using the agent's configured interval. Handles SIGINT to stop gracefully.

• status Show detailed status of the registered agent.

• agents List all agents associated with the configured API key.

• actions [--limit N] Display recent action log entries for the current agent (default limit 20).

• log <message> [--category X] [--details X] Record an action for the agent. Defaults to category system and marks the action as autonomous.

• domains List DNS domains owned by the account.

• sandboxes List sandboxes (VPS instances) for the account.

• engine Show status of the autonomic engine (tiers, thresholds, etc.).

• x402 Display payment configuration such as treasury address, USDC contract, and chain info.

• whoami Print current configuration (endpoint, masked API key, agent ID/name).

• version, -v, --version Print the CLI version.

• help, -h, --help Show this help text.

Configuration

All settings are stored in ~/.otonix/config.json with 0o600 permissions. Example:

{
	"apiKey": "otonix_abc123...",
	"endpoint": "https://app.otonix.tech",
	"agentId": "...",
	"agentName": "my-bot"
}

Development

npm install
npm run lint      # type check
npm run build     # produce dist/cli.js
npm run dev       # watch mode

The repository contains GitHub Actions workflows for CI and npm publishing.

License

MIT