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

# Install

> Install the Dome CLI and authenticate

Install the Dome CLI to manage agents, deploy rules, and operate the platform. The CLI also hosts the MCP server for AI assistants.

Dome is invitation-only. Your team and workspace must be provisioned before you can authenticate. Contact [support@domesystems.ai](mailto:support@domesystems.ai).

## Install the CLI

<Tabs>
  <Tab title="Homebrew (macOS and Linux)">
    ```bash theme={"system"}
    brew trust dome-systems/tap
    brew install dome-systems/tap/dome
    ```

    <Note>
      Homebrew 6 requires you to trust a third-party tap before it loads its formulae. On older Homebrew, `brew trust` is unnecessary and harmless.
    </Note>
  </Tab>

  <Tab title="Direct download">
    Set your platform, then extract the binary onto your `PATH`:

    ```bash theme={"system"}
    VERSION=0.2.0   # latest: https://github.com/dome-systems/releases/releases/latest
    OS=darwin       # or linux
    ARCH=arm64      # or amd64

    curl -sSL "https://github.com/dome-systems/releases/releases/download/v${VERSION}/dome_${VERSION}_${OS}_${ARCH}.tar.gz" | tar xz
    sudo mv dome /usr/local/bin/dome
    ```

    Each release also publishes `checksums.txt` and a per-archive SPDX SBOM. Verify a download with `shasum -a 256 -c checksums.txt --ignore-missing`.
  </Tab>
</Tabs>

Verify the installation.

```bash theme={"system"}
dome version
```

## Authenticate

Log in with your provisioned account.

```bash theme={"system"}
dome auth login
```

This opens a browser-based SSO flow. On success, the CLI stores a session token locally.

## Select a Workspace

List available workspaces and select an active context.

```bash theme={"system"}
dome context list
dome context use <workspace>
```

All subsequent commands operate within this workspace. Switch at any time with `dome context use`.

## Verify

Confirm your session and workspace:

```bash theme={"system"}
dome auth status
dome context current
```

## Next steps

* [Quickstart](/quickstart) to register your first agent and verify governed traffic
* [Setup AI assistant](/setup-ai-assistant) to connect an assistant through MCP
* [Personas](/personas) to identify your role and find relevant docs
* [CLI](/cli) for the full command reference