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 shows the organization's LLM token consumption for the selected period, with breakdowns by project, agent, and day, including prompt and completion tokens.

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, -d	Rolling window, in days	30
--month, -m	Full calendar month (YYYY-MM), for invoicing — overrides --days	—
--last-month	Full previous calendar month — overrides --days	—
--top	Number of top agents shown in the breakdown	10
--json, -j	Machine-readable output	—

If the usage export fails or times out, per-project and per-agent breakdowns may be unavailable. Organization totals and the daily breakdown remain exact.