Skip to main content

Organizations

Most CLI commands operate within the context of an organization. You can list, inspect, and switch between organizations.

Verbs: list, get, create, current, switch

List Organizations​

revos org list

Display specific columns:

revos org list --columns name,id

JSON output:

revos org list --json

Show Current Organization​

revos org current
revos org current --json

Switch Organization​

Interactive mode — presents a searchable list:

revos org switch

Direct switch by ID:

revos org switch <org-id>

JSON output requires an explicit ID (interactive selection needs a TTY):

revos org switch <org-id> --json

revos org switch updates your global default organization (used by commands run outside a Project). It does not change a Project's anchored org — that lives in the Project's revos.yaml. The CLI prints a warning if you run org switch inside a Project.

How revos org current resolves​

Inside a Project, revos org current reports the org from revos.yaml, since that's what apply / pull / diff will use. Outside a Project, it reports your global default from stored credentials (or REVOS_ORG_ID if set).

Targeting a different organization​

Inside a Project, the org is anchored in revos.yaml — --org and REVOS_ORG_ID are rejected on mismatch to prevent accidental cross-org writes. To target a different organization:

  • cd outside the Project tree and pass --org <id> or set REVOS_ORG_ID, or
  • Scaffold a new Project for that organization with revos init.

See Configuration for environment variables.