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

# Quickstart

> Onboard with the Gauge web product or CLI and inspect your first measurements.

You can onboard through the full Gauge web product or the Gauge CLI. Both options let you configure Agent Preference and Agent Experience measurements, manage run presets, launch runs, and inspect results.

## Onboard with the web product

Sign in at [agents.withgauge.com](https://agents.withgauge.com) and complete the guided onboarding flow. You can create or join an organization, seed starter measurements, configure runs, and review results without installing the CLI.

## Onboard with the CLI

### Prerequisites

Before you begin, install Node.js 22.12 or later.

<Steps>
  <Step title="Install the CLI">
    Install `gauge` from npm.

    ```bash theme={null}
    npm install -g @withgauge/cli
    ```
  </Step>

  <Step title="Create or join an organization">
    Run the guided onboarding flow. Gauge opens your browser to sign you in.

    ```bash theme={null}
    gauge onboard
    ```

    The command can create a workspace and seed starter Agent Preference and Agent Experience measurements.
  </Step>

  <Step title="Select an organization">
    List the organizations you can access, then save one as your default.

    ```bash theme={null}
    gauge orgs list
    gauge orgs use acme
    ```
  </Step>

  <Step title="Inspect your setup">
    View the organization summary and its measurements.

    ```bash theme={null}
    gauge status
    gauge preference list
    gauge evals list
    gauge presets list
    ```
  </Step>
</Steps>

<Tip>
  Run `gauge --help` or `gauge <command> --help` whenever you need the current options for a command.
</Tip>

## Next steps

<CardGroup cols={2}>
  <Card title="Learn how Gauge works" icon="diagram-project" href="/agents/concepts/how-gauge-works">
    Understand measurements, presets, cycles, runs, and experiments.
  </Card>

  <Card title="Automate with the CLI" icon="terminal" href="/agents/guides/cli">
    Use JSON output, environment variables, and declarative specs in CI.
  </Card>
</CardGroup>