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

# CLI Overview

> Install, authenticate, and navigate the Dome CLI

The `dome` CLI is the primary command-line interface for the Dome Platform.

## Installation

```bash title="macOS (Homebrew)" theme={"system"}
brew trust dome-systems/tap
brew install dome-systems/tap/dome
```

Homebrew 6 requires the `brew trust` line before it loads a third-party tap's formulae. Refer to [Install](/install) for the full walkthrough, including a direct-download alternative.

## Global Flags

All commands support these flags:

| Flag         | Type   | Description                                                                                                                                                                                                     |
| ------------ | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--context`  | string | Use a specific context (overrides active context)                                                                                                                                                               |
| `--server`   | string | Dome Platform server URL                                                                                                                                                                                        |
| `--activity` | string | Stable activity ID this run asserts. Every Connect RPC carries `X-Dome-Activity-Id` so audit events from the run share one [activity chain](/operate/audit#list-activity-chains). Overrides `DOME_ACTIVITY_ID`. |
| `--json`     | bool   | Output as JSON                                                                                                                                                                                                  |
| `--quiet`    | bool   | Minimal output (IDs only)                                                                                                                                                                                       |
| `--no-color` | bool   | Disable colored output                                                                                                                                                                                          |

## Environment Variables

| Variable           | Description                                                     |
| ------------------ | --------------------------------------------------------------- |
| `DOME_API_KEY`     | Sets the active context's token. Useful for CI and scripts.     |
| `DOME_ACTIVITY_ID` | Default activity ID for the process. `--activity` overrides it. |

## Command Groups

### Connect

| Command                           | Description                                           |
| --------------------------------- | ----------------------------------------------------- |
| [`agents`](/cli/connect/agents)   | Manage agent registrations, lifecycle, and API keys   |
| [`gateway`](/cli/connect/gateway) | Manage Gateways, membership, agent access, and quotas |
| [`tool`](/cli/connect/tools)      | Manage MCP server connections the gateway proxies     |
| [`model`](/cli/connect/models)    | Manage LLM model connections and routing pools        |

### Secure

| Command                      | Description                                                  |
| ---------------------------- | ------------------------------------------------------------ |
| [`rules`](/cli/secure/rules) | Deploy, validate, simulate, and rollback authorization rules |

### Operate

| Command                             | Description                                                              |
| ----------------------------------- | ------------------------------------------------------------------------ |
| [`audit`](/cli/operate/audit)       | Query, stream, and export audit events                                   |
| [`webhooks`](/cli/operate/webhooks) | Manage webhook subscriptions, delivery history, and the provider catalog |
| [`usage`](/cli/operate/usage)       | Show LLM token usage and estimated cost for the active workspace         |

### Settings

| Command                                        | Description                                                    |
| ---------------------------------------------- | -------------------------------------------------------------- |
| [`tenants`](/cli/settings/tenants)             | Create tenants under your active organization                  |
| [`workspace`](/cli/settings/workspace)         | Manage workspaces, members, act-as, and verification providers |
| [`platform-keys`](/cli/settings/platform-keys) | Manage platform API keys                                       |
| [`config`](/cli/settings/config)               | Platform configuration                                         |

### Developer

| Command                                       | Description                         |
| --------------------------------------------- | ----------------------------------- |
| [`quickstart`](/cli/developer/quickstart-cmd) | Scaffold a new Dome-enabled project |
| [`sandbox`](/cli/developer/sandbox)           | Provision sandbox environments      |

### Session

| Command                           | Description                                         |
| --------------------------------- | --------------------------------------------------- |
| [`auth`](/cli/session/auth)       | Authentication management                           |
| [`context`](/cli/session/context) | Manage CLI contexts (org/tenant/workspace sessions) |

### Standalone

| Command                              | Description              |
| ------------------------------------ | ------------------------ |
| [`mcp`](/cli/standalone/mcp)         | MCP server for AI agents |
| [`version`](/cli/standalone/version) | Show CLI version         |

## Next steps

Authenticate first, then scaffold — or drive the same jobs from MCP:

* [Install](/install) to authenticate and select a workspace
* [Quickstart](/quickstart) to scaffold and verify governed traffic
* [MCP](/reference/mcp) when you prefer tool-based access from an assistant
* [API](/api) for the management and data-plane HTTP surfaces