Bot Commands

The bot commands manage bot instances—running deployments of custom bots with specific configurations.

Deploy

Create a new bot instance from a configuration file:

the0 bot deploy <config.json>

The configuration file specifies which custom bot to use and provides parameter values:

{
  "name": "my-aapl-tracker",
  "type": "realtime/sma-crossover",
  "version": "1.0.0",
  "symbol": "AAPL",
  "short_period": 5,
  "long_period": 20,
  "update_interval_ms": 60000
}

Required fields:

• name - Unique identifier for this instance
• type - Format: {execution-model}/{custom-bot-name}
• version - Semantic version of the custom bot

Scheduled bots require a schedule field with a cron expression:

{
  "name": "daily-portfolio-check",
  "type": "scheduled/portfolio-tracker",
  "version": "1.0.0",
  "schedule": "0 9 * * *",
  "symbols": ["BTC", "ETH", "SOL"]
}

Additional fields depend on the custom bot's schema. Use the0 custom-bot schema to view required parameters.

List

Display all deployed bot instances:

the0 bot list

Output shows instance ID, name, type, version, schedule (if applicable), and timestamps.

Update

Update an instance's configuration and/or version:

the0 bot update <bot_id> <config.json>

This updates configuration values and, if the version field has changed, points the instance to the new custom bot code and frontend. The bot keeps its ID and all persisted state.

Minor/patch version bumps (e.g. 1.0.0 → 1.0.1 or 1.1.0) are applied in place. Major version bumps (e.g. 1.x → 2.0) are rejected — use bot delete + bot deploy for those, since they may be incompatible with existing state. See Version Management for details on what counts as a breaking change.

Delete

Remove a bot instance:

the0 bot delete <bot_id>

The CLI prompts for confirmation before deletion. Use -y or --yes to skip the prompt:

the0 bot delete <bot_id> -y

Logs

View execution logs for a bot instance:

the0 bot logs <bot_id>

Options:

• --limit <n> - Maximum entries to return (1-1000, default 100)
• -w, --watch - Stream logs in real-time (polls every 5 seconds)

Date filtering (format: YYYYMMDD or YYYYMMDD-YYYYMMDD):

# Logs from a specific date
the0 bot logs <bot_id> 20250115

# Logs from a date range
the0 bot logs <bot_id> 20250115-20250120

Examples:

# Last 50 log entries
the0 bot logs abc123 --limit 50

# Watch logs in real-time
the0 bot logs abc123 -w

# Logs from today with limit
the0 bot logs abc123 20250115 --limit 200

Enable / Disable

Start or stop a bot instance without deleting it:

# Enable a stopped bot
the0 bot enable <bot_id>

# Disable a running bot
the0 bot disable <bot_id>

State

Manage persistent bot state. State is automatically synced between the bot container and cloud storage.

List State Keys

List all state keys stored by a bot:

the0 bot state list <bot_id>

Output shows key names and sizes in a table format.

Get State Value

Retrieve the value of a specific state key:

the0 bot state get <bot_id> <key>

Returns the state value as formatted JSON.

Delete State Key

Delete a specific state key:

the0 bot state delete <bot_id> <key>

Clear All State

Delete all persistent state for a bot:

the0 bot state clear <bot_id>

The CLI prompts for confirmation. Use -y or --yes to skip:

the0 bot state clear abc123 -y

Query

Execute queries against running or scheduled bots. Queries provide read-only access to bot data.

the0 bot query <bot_id> <path> [options]

Options:

• --params, -p <json> - Query parameters as JSON object
• --timeout, -t <seconds> - Query timeout (default: 30)
• --raw, -r - Output raw JSON without formatting

Examples:

# Basic query
the0 bot query abc123 /status

# Query with parameters
the0 bot query abc123 /signals --params '{"limit": 5}'

# Query with timeout for slow scheduled bots
the0 bot query abc123 /portfolio --timeout 60

# Raw output for scripting
the0 bot query abc123 /history --raw | jq '.data[0]'

Latency notes:

• Realtime bots: Queries are proxied to the running container (~10-50ms)
• Scheduled bots: Queries spawn ephemeral containers (~1-3s startup)

See Query Handlers for implementing query endpoints in your bots.

Cron Schedule Format

Scheduled bots use standard cron expressions:

┌───────────── minute (0-59)
│ ┌───────────── hour (0-23)
│ │ ┌───────────── day of month (1-31)
│ │ │ ┌───────────── month (1-12)
│ │ │ │ ┌───────────── day of week (0-6, Sunday=0)
│ │ │ │ │
* * * * *

Examples:

Expression	Description
* * * * *	Every minute
0 * * * *	Every hour
0 9 * * *	Daily at 9:00 AM
0 9 * * 1-5	Weekdays at 9:00 AM
*/15 * * * *	Every 15 minutes
0 0 1 * *	First day of each month

Related

• Custom Bot Commands - Deploy custom bots and view schemas
• Bots - Understanding bot instances