What it does
Gauge CLI is an open-source tool for improving agent experience: how easily coding agents discover and use your skills, CLIs, SDKs, MCP servers and documentation. It runs real agents such as Claude Code, Codex, Pi and OpenCode against realistic tasks in your product, captures where they get stuck, and lets your own coding agent try fixes before you release them. Typical findings include an interactive command that blocks an agent, an agent reaching for deprecated commands or outdated APIs, a skill that goes unused when it should help, or an agent claiming a limitation that does not exist. The fix might be an error message, help text, skill content, code or docs, and Gauge measures whether each change helped so you can repeat the loop. Everything runs locally in Docker with your existing agent logins or API keys, and no Gauge account is required; agent usage is billed through your own provider. It needs Node.js 22.13 or later and Docker, and the CLI is MIT licensed.
Who it’s for
Teams that ship developer tools, SDKs or docs and want coding agents to use them well.
Use cases
- Testing whether coding agents can follow your API docs
- Finding CLI commands that hang when an agent runs them
- Measuring whether a rewritten skill actually gets used

