gauge-sh/gauge-cli

Gauge CLI

<picture> <source media="(prefers-color-scheme: dark)" srcset="docs/assets/gauge-logo-dark.svg"> <source media="(prefers-color-scheme: light)" srcset="docs/assets/gauge-logo-light.svg"> <img alt="Gauge" src="docs/assets/gauge-logo-light.svg" width="800"> </picture>

An open-source CLI for hillclimbing Agent Experience.

Make your Skills, CLIs, SDKs, MCPs and docs easier for coding agents to discover and use. Gauge runs real agents against your product, captures where they get stuck, and lets your own coding agent test fixes before you publish them.

The full loop runs locally with Docker and your existing agent subscriptions or API keys. No Gauge account required.

Website · Documentation · Hosted Gauge · npm · Changelog

What does Gauge find?

Gauge runs and analyzes coding sessions to find the issues that coding agents run into.

Common findings include:

• An interactive command blocks a coding agent
• An agent reaches for deprecated commands or outdated API patterns
• A Skill goes unused even when it should help with the task
• An agent confidently claims a limitation that does not exist
• An agent cannot figure out the intended workflow across multiple commands

The right fix might change error messages, Skill content, help text, code, or documentation. The Gauge CLI lets you validate proposed fixes before release.

Quickstart

Gauge is designed to be used by your coding agent. Point it at this r