> ## Documentation Index
> Fetch the complete documentation index at: https://octolens.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Global flags

> The 6 flags every octolens command accepts.

Every `octolens` command accepts these, on top of its own flags.

| Flag          | Type                    | Required (headless) | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| ------------- | ----------------------- | ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--base-url`  | `string`                | no                  | Override the app base URL (env OCTOLENS\_BASE\_URL) — one resolution feeds the REST API base, --web pages, billingUrl, and OAuth handoffs; defaults to [https://app.octolens.com](https://app.octolens.com)                                                                                                                                                                                                                                                                                                                                                                                                |
| `--json`      | `boolean`               | no                  | Output pure machine-readable JSON (no decoration)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| `--timeout`   | `integer`               | no                  | Per-request deadline in seconds (default 30). When it expires the request is aborted and the run exits 1 with a REQUEST\_TIMEOUT (504) envelope instead of blocking — EXCEPT when a state-changing request had already returned its 2xx status line, where the write was accepted and may have landed, so the answer is RESPONSE\_LOST (502, exit 10): verify with the matching list/get before retrying. Overrides the longer per-operation defaults too. Also governs login's out-of-band browser-handoff wait (--no-browser included; default 180s there), where expiry exits 2 LOGIN\_TIMEOUT instead. |
| `--transport` | `rest` (the only value) | no                  | Force the backend transport: rest = the public REST v2 API (the only one in this build)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `--verbose`   | `boolean`               | no                  | Show diagnostic logs on stderr (same as OCTOLENS\_DEBUG=1): one line per REST request — method, path, status, duration — plus retry/backoff events                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `--web`       | `boolean`               | no                  | Open this resource's page in the Octolens web app instead of running the command (prints the URL; only a TTY spawns the browser)                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |