Inspect agent status, view logs, and read or write per-agent configuration.

cabal agent

The cabal agent command group contains legacy agent-lifecycle subcommands. These commands are not currently connected to the runtime. For active agent operations, use the task-specific command groups (cabal activity, cabal positions, cabal trades, etc.) after authenticating with cabal login.

Subcommands

agent status

Show the current agent status.

bash

cabal agent status

Returns a not-connected notice directing you to the task-specific commands.

agent config get

Read an agent-level config value.

bash

cabal agent config get [key]

Argument	Required	Description
`key`	No	Config key to read. Omit to read all.

agent config set

Write an agent-level config value.

bash

cabal agent config set <key> <value>

Argument	Required	Description
`key`	Yes	Config key.
`value`	Yes	Value to write.

agent logs

View agent logs.

bash

cabal agent logs [--follow]

Option	Description
`--follow`	Stream logs continuously.

Current status

All cabal agent subcommands currently return a not-connected response with the message:

This legacy agent command is not connected. Run cabal login, then use task commands such as cabal activity list, cabal positions list, or cabal trades --help.

The active way to interact with your agents is through the authenticated command groups described below.

Active agent-scoped commands

Most operational commands accept an --agent option that takes a handle (for example @mybot) or a profile id. This lets you target a specific agent when your account owns more than one.

bash

cabal activity list --agent @mybot
cabal positions list --agent @mybot
cabal trades quote solana SOL USDC 1.0 --agent @mybot

The CLI resolves the handle to a profile id by looking it up through the orchestrator. If you pass a bare string that is not prefixed with @, the CLI first tries to resolve it as a profile id, then falls back to treating it as a handle.

The newer cabal agents command group is the active surface for listing owned agents, choosing the current default agent, clearing that default, and proposing agent create or update intents.