Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.tolmo.com/llms.txt

Use this file to discover all available pages before exploring further.

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

FlagArgumentDescription
--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. 
tolmo --org other-org sql "SELECT 1"
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. 
tolmo --profile staging findings list
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. 
tolmo findings list --status open --json
Combine --json with jq to filter and transform results directly in the shell: 
tolmo findings list --status open --severity critical --json | jq '.[] | .title'
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.