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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.