Tolmo supports a set of global flags that you can pass to any command. These flags let you override the active organization, switch profiles, or change output format on a per-command basis — without modifying your stored configuration. Combining them gives you precise control over every command without touching ~/.tolmo/ or your shell environment.
Flag reference
| Flag | Argument | Description |
|---|
--org | <slug> | Override the active organization for a single command |
--profile | <name> | Use a named profile instead of the default |
--json | — | Output raw JSON instead of a formatted table |
—org
Use --org to target a different organization for a single command without switching your active profile. This is useful for one-off queries or operations against an org you don’t work with regularly.
The flag accepts an organization slug, which you can find in your Tolmo dashboard or by running tolmo org list. It overrides the org embedded in the active profile for that invocation only — your default profile is unchanged afterward.
—profile
Use --profile to run a command using a specific named profile’s credentials and org context. This is the per-command equivalent of setting TOLMO_PROFILE in your shell.
The command above authenticates with the staging profile and targets whichever organization that profile is associated with. See Named Profiles for details on creating and managing profiles.
—json
Use --json to receive raw JSON output instead of the default formatted table. This makes it straightforward to parse command output in scripts or pipe it to other tools.
Combine --json with jq to filter and transform results directly in the shell:
Always use --json when piping Tolmo output to other tools or scripts. The formatted table output is designed for human readability and may change between releases; the JSON schema is stable and machine-friendly.
