Spend commands
anycloud cost
anycloud cost [deployment-id] [options]
| Option | Description |
|---|---|
-p, --period PERIOD | Whole days from 1d to 90d; default 30d |
--session ID | Session ID, prefix, label, or agent:hash |
--agent NAME | One detected agent |
--json | Compact cost report |
Without an ID, the report includes Jobs and Servers. A Server overlapping the
window is included even if it started earlier, with duration and cost clipped
to the overlap. Aggregate JSON includes totalJobs, totalServers, and Job /
Server counts in each byProvider and byAgent entry.
Reports matching more than 1,000 deployments require a shorter period or narrower session/agent filter rather than returning partial totals.
anycloud throttle
anycloud throttle set [usd-per-hour] [--agent-session]
anycloud throttle show
anycloud throttle unset [--agent-session]
| Option | Description |
|---|---|
--agent-session | Set or remove an independent cap for each detected session |
Throttle gates a candidate when estimated running VM dollars per hour plus the candidate is greater than or equal to the cap. Running deployments continue.
anycloud budget
anycloud budget set [usd] --per <day|week|month> [--agent-session]
anycloud budget show
anycloud budget unset --per <day|week|month> [--agent-session]
| Option | Description |
|---|---|
--per PERIOD | Required UTC window: day, week, or month |
--agent-session | Set or remove a per-session budget |
anycloud spend
anycloud spend show [--json]
--json adds percentUsed and headroomUsd fields and omits terminal bars
and color.
See Spend Controls for dispatch behavior and scope.