> ## 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.

# Global Flags Reference for Every Tolmo CLI Command

> Use --org, --profile, and --json on any Tolmo command to override the active org, switch profiles, or get machine-readable JSON output per invocation.

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.

```bash theme={null}
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.

```bash theme={null}
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](/configuration/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.

```bash theme={null}
tolmo findings list --status open --json
```

Combine `--json` with `jq` to filter and transform results directly in the shell:

```bash theme={null}
tolmo findings list --status open --severity critical --json | jq '.[] | .title'
```

<Tip>
  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.
</Tip>