AgentSea CLI

Reference for the agentsea CLI. To get a launch-ready install + run snippet, pick an agent and a cloud on the homepage.

Install

One curl pipe. Works on macOS, Linux, and WSL — installs to ~/.local/bin and adds it to PATH for new shells.

install

curl -fsSL https://agentsea.dev.thegrid.ai/install.sh | bash

Common commands

shell

agentsea                                # Interactive picker
agentsea <agent> <cloud>                # Launch directly (e.g. openclaw digitalocean)
agentsea ls                             # List your deployments
agentsea matrix                         # Agent x cloud support matrix
agentsea --help                         # Full flag reference

Environment variables

agentsea reads from your shell, then from .env at the repo root, then from saved config under ~/.config/agentsea/.

env

# Grid platform (required for inference + dashboard)
export THEGRID_API_KEY=...     # create at https://app.thegrid.ai

# Per-cloud tokens (only the one you launch into)
export DIGITALOCEAN_ACCESS_TOKEN=...
export HCLOUD_TOKEN=...                   # Hetzner
# (AWS / GCP follow their SDK conventions)

Missing something?

Run agentsea --help for the full flag reference, or request a missing agent.