Looking for the Gauge you already use?Go to Gauge Chat
Check your AX ↗PricingloginGet Started

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 CLIRead the guide ↗

Gauge Agents CLI

Your next evaluation starts here

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.

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

    npm install -g @withgauge/cli

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

    gauge auth login
gauge orgs use <org>

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

    gauge instructions
gauge --help

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

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

FAQs

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.
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.
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.
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 ↗Open Gauge Agents ↗Agents pricing ↗Explore Agent Led Growth ↗