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 parameters:

the0 bot update <bot_id> <config.json>

This updates configuration values but does not change the custom bot version. To use a different version, delete the instance and deploy a new one.

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