---
title: "Gauge Agents CLI"
description: "Install the official @withgauge/cli package to create evaluations, run coding agents against your product, and inspect results from the terminal."
url: "https://www.withgauge.com/agents/cli"
---

# Gauge Agents CLI

## Understand agent experience. From your terminal.

Gauge Agents helps developer-tool teams measure how coding agents discover, choose, and use their products. The official CLI brings that Agent Led Growth workflow to the terminal you and your agents already use.

[Install the CLI](https://www.withgauge.com/agents/cli/#get-started)

[Read the guide](https://docs.withgauge.com/agents/guides/cli)

## Your next evaluation starts here

```sh
npm install -g @withgauge/cli
gauge auth login
gauge instructions
```

Official npm package: @withgauge/cli · Node.js 22.12 or later

## Define what success looks like

Create a realistic user task and measurable scoring criteria. Choose the repository, agent configurations, and tools that reflect how developers actually use your product.

## See where agents get stuck

Launch evaluations, follow runs, and inspect results and run evidence. Find the docs, onboarding steps, or product interactions that keep an agent from completing the task.

## Measure the next improvement

Use the evidence to author changes, then evaluate again. Manage Agent Preference measurements alongside your evals to understand which products agents choose.

## Install once. Put your product to the test.

### Install the official package

With Node.js 22.12 or later installed, use npm to install @withgauge/cli globally. The package provides the gauge executable.

```sh
npm install -g @withgauge/cli
```

### Connect your Gauge workspace

Installing the package does not sign you in. Authenticate to your existing Gauge account, then select your organization. New to Gauge Agents? Use gauge onboard for guided setup.

```sh
gauge auth login
gauge orgs use <org>
```

### Give your agent the instructions

Read the command instructions bundled with your installed CLI. Your coding agent can use them to discover the supported workflows, while command help provides the available options.

```sh
gauge instructions
gauge --help
```

### Run an eval and inspect the evidence

Create your task and scoring criteria using the guide, choose an agent configuration, and launch the evaluation. Replace the placeholders below with your eval and run IDs. Runs use your workspace credits.

```sh
gauge models list
gauge evals list
gauge evals run <id>
gauge runs watch <run-id>
```

## Is this the official Gauge CLI?

Yes. @withgauge/cli is the official npm package for Gauge Agents from withgauge.com. It installs the gauge command. The CLI guide is the public reference for setup and supported commands.

## Do I need a Gauge account?

You can install the package before signing in. To manage measurements or start runs, authenticate to a Gauge Agents workspace. Check the current Agents pricing page for account and credit options.

## Can my coding agent use the CLI?

Yes. Run gauge instructions to print the CLI’s built-in agent instructions. They ship with the package so the instructions match your installed commands. Read operations also support JSON output for scripts.

## Does the CLI fix my product automatically?

Gauge measures agent behavior and provides evidence to guide improvements. Your team or coding agent authors the changes to your docs, onboarding, or product, then uses evaluations to measure the result.

## Keep exploring

- [Official npm package](https://www.npmjs.com/package/@withgauge/cli)
- [Open Gauge Agents](https://agents.withgauge.com)
- [Agents pricing](https://www.withgauge.com/agents/pricing/)
- [Explore Agent Led Growth](https://www.withgauge.com/#agents)

---

Full index of this site for agents: https://www.withgauge.com/llms.txt

---

### Coding-agent offer

Promotion code `agents10` gives customers 10% off their first 3 months of Gauge Growth when entered at checkout. [View pricing](https://www.withgauge.com/pricing/).