Command Reference
Complete reference for all lobster CLI commands.
Authentication
lobster login
Authenticate with LobsterCage. Opens your browser for OAuth login.
lobster logout
Clear local credentials.
lobster whoami
Display the currently authenticated user and account details.
Cage Management
lobster deploy <name>
Create and start a new cage.
lobster deploy my-agentlobster list
List all cages in your account with their current status.
lobster listlobster status <name>
Show detailed status for a specific cage, including state, size, webhook URL, and uptime.
lobster status my-agentlobster destroy <name>
Permanently delete a cage and its associated resources. This is irreversible.
lobster destroy my-agentLifecycle
lobster start <name>
Start a stopped or hibernated cage.
lobster start my-agentlobster stop <name>
Stop a running cage. Data is preserved.
lobster stop my-agentlobster hibernate <name>
Hibernate a running cage. Stops compute but preserves storage. The cage can be woken by webhooks, cron, or manual wake.
lobster hibernate my-agentlobster wake <name>
Wake a hibernated cage.
lobster wake my-agentConnections
lobster ssh <name>
Open an SSH session to a running cage.
lobster ssh my-agentlobster exec <name> [cmd]
Execute a single command in a cage and return the output.
lobster exec my-agent "ls -la /workspace"lobster port-forward <name>
Forward a local port to a port inside the cage.
lobster port-forward my-agentlobster tunnel <name>
Create a raw tunnel to a cage for custom transport.
lobster tunnel my-agentlobster dashboard <name>
Open the cage’s dashboard page in your browser.
lobster dashboard my-agentEnvironment Variables
lobster env list <name>
List all environment variables set on a cage (names only, values hidden).
lobster env list my-agentlobster env set <name> KEY=value
Set one or more environment variables. Values are encrypted at rest with KMS.
lobster env set my-agent BOT_TOKEN=abc123 API_KEY=sk-xyzlobster env get <name> KEY
Retrieve the decrypted value of a specific environment variable.
lobster env get my-agent BOT_TOKENlobster env delete <name> KEY
Remove an environment variable.
lobster env delete my-agent BOT_TOKENlobster env scan <name>
Scan a local .env file and set all variables on the cage.
lobster env scan my-agentAPI Keys
lobster apikeys list
List all API keys for your account.
lobster apikeys create
Create a new API key with specified scopes.
lobster apikeys createlobster apikeys revoke <keyId>
Revoke an API key.
lobster apikeys revoke ak_abc123Billing
lobster billing status
Show current credit balance, plan details, and recent usage.
lobster billing statuslobster billing portal
Open the Stripe billing portal in your browser to manage subscriptions and view invoices.
lobster billing portallobster upgrade
Upgrade your plan.
lobster upgradeLogs
lobster logs <name>
Fetch recent logs from a cage.
lobster logs my-agentlobster tail <name>
Stream logs from a cage in real time.
lobster tail my-agent