Hi HN, I’m Evan from Gauge. We’re open-sourcing our CLI to recursively improve your docs for coding agents. The CLI includes a local execution backend, so you don't need an account to try it. Explainer video here: https://youtu.be/zhLUlIKB1MgThe CLI supports a hillclimbing loop:- set up tasks for coding agents that would need your docs, like 'set up Gauge CI checks'- run the tasks- analyze session transcripts for friction or failures- create variants of your docs to resolve the issues- re-run the tasks with the doc variants injected (transparently, at the same hostname)- repeat until you have a variant that resolves the issuesThe same loop supports hillclimbing your Skills, CLI, and other agent-facing surfaces.We started out 2 years ago building open-source developer tools (like Tach https://github.com/tach-org/tach), then pivoted to AI Search optimization, and are now focused on the intersection of the two spaces. We were already working with awesome devtool companies, and they were the first ones to ask us how to optimize for Claude Code and Codex. We realized this would be something that eventually every company needs to do. Our CLI provides primitives for docs/devrel/eng teams to measure, analyze, and improve how coding agents use their product.The design boils down to two components: VMs and a network gateway.The VMs are straightforward, we want the agents to be highly privileged within their environment so that they are representative of developers' coding agents. Each VM generally comes with the agent harness itself, language toolchains, and a git repository.The network gateway is where we terminate TLS and swap in variants of your docs transparently. The gateway also handles credential replacement, so agents see placeholders and can't exfiltrate keys.The CLI comes with a 'local' execution backend (inference is still remote). For VMs, it uses Docker containers, and the network gateway is mitmproxy running in a sidecar container for each session.We've used the hillclimbing loop internally to find and fix coding agent issues like mistaken pricing, inaccurate product limitations, and repeated workarounds. We saw coding agents report that Gauge only supports Claude Code and Codex, traced it back to the web pages they fetched, and fixed the behavior (we support Pi, OpenCode, and Antigravity as well). For Clerk, we helped shift coding agents from their legacy 'keyless' mode to their new 'clerk init' command. They were able to validate a pre-release change to their SDK's error messages using Gauge, then saw a 3x increase in coding agents using 'clerk init' post-deploy.Due to the 'static' nature of AI models, we've realized that closed-loop optimization techniques are now possible for essentially all software products. The same agent can be simulated over and over, meaning that a h
Show HN: Gauge – Open-Source CLI to recursively improve your docs
:dog: The open-source Gauge CLI. Hillclimb your Skills, CLI, SDK, MCP, API, or Docs to make something agents want. - gauge-sh/gauge-cli
Key takeaways
Gauge is an open-source CLI tool that helps improve documentation by testing fixes with coding agents before release.
- Gauge uses coding agents to find issues in documentation and code.
- It supports multiple agents like Claude Code and Codex.
- Users need Node.js, Docker, and agent credentials to use it.
Summarised automatically by AI from the original article by Hacker News. AI can make mistakes, so check the original for details.
Story details
- Published
- By
- 0x63_Problems
- Format
- Article
- Original
- github.com ↗
Related reporting
6 stories on this topic from 3 sources, oldest first.
- Hacker News Show HN: Gauge – Open-Source CLI to recursively improve your docs (this story)





