org

Manage the organizations you belong to and set the default used by every other command.

Usage

machina org list                       # list organizations
machina org list --limit 5             # paginate (5 per page)
machina org list --page 2              # page 2
machina org list --json                # output as JSON
machina org create <name>              # create an organization
machina org use <org-id>               # set the default organization
machina org usage                      # LLM token consumption rollup (last 30d)
machina org usage --days 7 --top 10    # window + top-N breakdown

Subcommands

Command	Description
`org list`	List organizations you belong to
`org create <name>`	Create a new organization
`org use <org-id>`	Set the default organization (writes `default_organization_id` to config)
`org usage`	Aggregate LLM token consumption across the org’s agent executions

list supports the global --limit, --page, and --json flags — see Configuration → Global flags.

usage — token consumption

machina org usage answers “how many LLM tokens did this org consume”. Token usage is recorded on agent executions (execution_tokens), and the Client-API totals are page-level only, so the command iterates the org’s projects, paginates + sums client-side, and breaks the total down by project, agent, and day — surfacing the prompt/completion split (the cost-shape signal).

machina org usage --days 30 --top 10 --json

Flag	Purpose	Default
`--org`, `-o`	Organization (defaults to the selected org)	selected org
`--project`, `-p`	Scope to a single project	all projects
`--days`	Rolling window (a frozen upper bound keeps pagination stable)	`30`
`--top`	Top-N agents/projects in the breakdown	—
`--limit`	Max rows	—
`--json`, `-j`	Machine-readable output	—

Unreachable / undeployed projects are listed under projects_unreachable rather than failing the run; a project that is reachable but errors mid-scan flags the run INCOMPLETE / PARTIAL (a partial total is never presented as if it were whole).

Get started

Using the CLI

Platform

Resources

Operations

Usage

Subcommands

usage — token consumption

​Usage

​Subcommands

​usage — token consumption

Usage

Subcommands

usage — token consumption