the0 CLI

The the0 CLI is the primary interface for deploying custom bots and managing bot instances on the0 platform. It handles authentication, dependency vendoring, compilation, and deployment.

Command Groups

The CLI is organized into the following command groups:

auth - Manage authentication

the0 auth login          # Set API key for the active environment
the0 auth logout         # Remove the API key for the active environment
the0 auth status         # Check authentication status
the0 auth secrets        # Manage build secrets

env - Manage named API environments

the0 env add <name> --url <url>  # Add a new environment (validates key)
the0 env use <name>              # Switch active environment
the0 env list                    # List all environments
the0 env remove <name>           # Delete an environment
the0 env current                 # Show the active environment

custom-bot - Deploy and manage custom bot definitions

the0 custom-bot deploy           # Deploy from current directory
the0 custom-bot list             # List deployed custom bots
the0 custom-bot versions <name>  # List versions of a custom bot
the0 custom-bot schema <version> <name>  # Get schema for a custom bot

bot - Manage bot instances

the0 bot deploy <config.json>    # Deploy a bot instance
the0 bot list                    # List bot instances
the0 bot update <id> <config>    # Update instance configuration
the0 bot delete <id>             # Delete an instance
the0 bot logs <id>               # View instance logs

local - Manage local Docker Compose development environment

the0 local init                         # Initialize local environment and prompt for root admin credentials
the0 local init --email <email> --password <password>
the0 local start                        # Start all services
the0 local reset-admin-password <password>
the0 local stop                         # Stop all services
the0 local status                       # Show service status
the0 local logs [service]               # View service logs
the0 local dev                          # Start in development mode

update - Self-update the CLI

the0 update                # Update to latest version

Global Flags

All commands support the following flags:

-v, --verbose      Enable verbose output
    --env <name>   Use the named environment for this command
-h, --help         Show help for any command

Documentation

• Installation - Install the CLI
• Authentication - Configure API credentials
• Environments - Manage multiple API endpoints (local, prod, ...)
• Bot Commands - Bot instance management reference
• Custom Bot Commands - Custom bot deployment reference
• Local Development - Local environment management reference
• Secrets - Configure private dependencies