--- title: "Open-Sourcing the Gauge CLI" description: "The Gauge CLI is now open source, with a free local backend for Gauge Agents. Run real coding agents against your product in Docker, find where they struggle, and test fixes. No Gauge account needed." url: "https://www.withgauge.com/blog/launch-week-open-source-cli/" author: "Evan Doyle" published: "2026-11-05" --- # Open-Sourcing the Gauge CLI Today we're open-sourcing the Gauge CLI under the MIT license, including a local backend for Gauge Agents. With the local backend, you can run Claude Code, Codex, Pi, or OpenCode against your product in Docker on your own machine. The agents use the subscription or API key you already have. Running the CLI locally is free and doesn't need a Gauge account. The code is on GitHub at [github.com/gauge-sh/gauge-cli](https://github.com/gauge-sh/gauge-cli). [The open-source Gauge CLI: run coding agents against your docs and fix what breaks (video)](https://www.youtube.com/watch?v=zhLUlIKB1Mg) ## Why we built this Until today, running Gauge Agents meant signing up for our hosted platform. The open-source, local backend removes that step. If you have Docker and a Claude or Codex login, you can use Gauge to optimize for your users' coding agents. We believe that this capability is table stakes for any company developing a software product, and the open-source Gauge CLI is the best option available to get started. ## How it works The CLI works with Gauge's hosted platform for both Gauge Chat and Gauge Agents. The open-source release adds a second backend for Agents, which runs on your machine: 1. **Set up a workspace.** `gauge init --local` creates a private `.gauge/` directory in your project. A SQLite database there stores your evals, runs, and findings. 2. **Start fresh sessions.** Each session runs in a new Docker container in place of a hosted Gauge VM. The runtime image includes the agent harnesses and standard dev tools, and it runs natively on Intel and Apple Silicon. 3. **Install your product.** Gauge adds your product's inputs to each session from your working tree: a Skill, an npm CLI or SDK, docs files, or web fixtures that replace the pages an agent fetches. 4. **Run real agents.** Claude Code uses your Claude login or `ANTHROPIC_API_KEY`. Codex, Pi, and OpenCode use `codex login`. Agent usage is billed through your provider. 5. **Analyze with your own agent.** Gauge saves transcripts and diffs in a consistent format, whichever agent ran the session. Your coding agent reads them, judges each run against your criteria, and saves structured findings back to Gauge. ## The improvement loop The local improvement loop on your machine: write a task, run agents in Docker, find friction, then fix and compare, rerunning with your changes Gauge is built to be driven by your coding agent. Install the Gauge skill and ask your agent to find where agents struggle with your product. It writes representative tasks, launches the runs, reads the sessions, and proposes a fix. During development, the Gauge CLI lets you install pre-release builds of your docs, CLI, or SDK. This lets you see how your changes will affect coding agents before you publish. Run `gauge watch` to follow your sessions live in the browser. ## What you can find Local runs surface the same kinds of friction we see in hosted Gauge: - **Blocked commands.** An interactive prompt or login flow stalls the agent. - **Outdated patterns.** The agent reaches for deprecated commands or old API shapes. - **Unused Skills.** A Skill that would help goes unread. - **False limitations.** The agent confidently claims your product can't do something it can. - **Lost workflows.** The agent can't work out how your commands fit together. You can also measure Agent Preference: give an agent an open-ended task like `gauge run "Which CLI should I deploy with?"` and see which product it picks and why. ## Get started Install the CLI and the Gauge skill, then ask your coding agent to get started: ```bash npm install -g @withgauge/cli gauge local runtime pull gauge init --local gauge install-skill ``` When you're ready to run agents at scale, share results with your team, or test against authenticated connections like your MCP/API, the same CLI works with hosted Gauge. Issues are welcome on [GitHub](https://github.com/gauge-sh/gauge-cli). If you build something on top of the local backend, we'd love to hear about it. This post is part of [Gauge Launch Week](https://www.withgauge.com/blog/gauge-launch-week/). --- Full index of this site for agents: https://www.withgauge.com/llms.txt --- ### AI Visibility Growth offer For AI Visibility Growth only. Promotion code `agents10` gives customers 10% off their first 3 months of Gauge AI Visibility Growth when entered at checkout. [View pricing](https://www.withgauge.com/pricing/).