Stage CLI is an open-source command-line tool that reorganizes AI-generated code changes into logical chapters, displayed in a browser-based interface. It aims to simplify code review by presenting diffs in a narrative order rather than the repository tree order typical of IDEs and CLI diff tools.
What it does
Stage CLI works with any coding agent. After installing the tool and adding its skill to your agent, you run /stage-chapters on your current branch. The agent reads the local changes, breaks them into separate logical chapters, and opens them in a local browser. Each chapter groups related modifications, with annotations pointing out what to review before diving into the code.
How to install it
- Install the CLI globally via npm:
npm install -g stagereview - Add the skill to your agent:
npx skills add ReviewStage/stage-cli - In your AI agent, run:
/stage-chapters
Everything runs locally on your machine. No data is sent to external servers.
Tradeoffs
- Browser dependency: The interface opens in a browser, which may be inconvenient for developers who prefer terminal-only workflows.
- Agent compatibility: While it works with any coding agent, the skill installation step assumes a compatible agent environment.
- No GitHub integration in CLI version: The CLI version is local-only. The full Stage experience with GitHub integration is available at stagereview.app.
When to use it
Stage CLI is useful when reviewing large or complex AI-generated changes where the repository tree order makes it hard to follow the logical flow of modifications. It is also helpful for teams that want a consistent, chapter-based review process before opening a pull request.
Bottom line
Stage CLI offers a practical alternative to traditional diff viewers for AI-generated code. It is free, open-source (MIT license), and easy to install. If you find yourself struggling to follow AI-generated changes in your IDE or CLI, it is worth trying.