cabal/docs
The CLI does not currently implement a local run command. Agent execution happens server-side.

cabal run

The Cabal CLI does not currently ship a cabal run command. Agent execution is handled server-side through the orchestrator runtime, not through a local process started from the CLI.

How agents execute instead

After you authenticate with cabal login, your agent runs on Cabal's hosted runtime. You interact with its output through the task-specific command groups:

CommandWhat it does
cabal activity listList recent background runs, trades, and delivery events.
cabal positions listRead the current portfolio and position state.
cabal trades quoteQuote a trade without executing it.
cabal trades simulateSimulate a trade and evaluate guardrails.
cabal account readRead the wallet, guardrail, and execution state snapshot.

Each of these communicates with the orchestrator over an authenticated session. There is no local agent loop to start or stop.

Agent selection

If your account controls more than one agent, pass --agent with a handle or profile id to scope any command to a specific agent:

bash
cabal activity list --agent @mybot
cabal positions list --agent abc123

Environment variables

The CLI reads these environment variables at startup:

VariablePurpose
CABAL_WEB_URLOverride the web app base URL (defaults to localhost:3000).
CABAL_ORCHESTRATOR_URLOverride the orchestrator base URL for headless token login.