hub / github.com/ReviewStage/stage-cli

github.com/ReviewStage/stage-cli @main

776 symbols 2,100 edges 221 files 19 documented · 2%

What it actually does AI analysis from the code graph — generated when you open this

loading…

README

Stage

A code review tool that organizes local code changes into logical chapters and points out what to review before you dive into the code.

If you like this, try out the full Stage experience on our website below!

Website • Examples • Blog • Twitter • Discord • About Us

Install

npm install -g stagereview

Then add the skill to your agent:

npx skills add ReviewStage/stage-cli

Uninstall

npx skills remove ReviewStage/stage-cli
npm uninstall -g stagereview

Usage

In your AI agent, run:

/stage-chapters

This organizes your local changes into reviewable chapters and opens a browser UI. Everything happens on your machine.

Options

Flag	Description
`--base <ref>`	Base ref to diff against (default: auto-detect main/master)
`--compare <ref>`	Compare ref to diff against `--base`
`--ref <mode>`	Diff scope: `work` (staged + unstaged + untracked), `staged`, or `unstaged` (default: auto-detect)
`--pr <number-or-url>`	Review a GitHub pull request by number or URL (requires `gh`)

Examples:

# Review only staged changes
/stage-chapters --ref staged

# Diff against a specific branch
/stage-chapters --base feature-a

# Compare two branches
/stage-chapters main feature
/stage-chapters main..feature
/stage-chapters --base main --compare feature

# Review a teammate's PR by number or URL
/stage-chapters --pr 123
/stage-chapters --pr https://github.com/owner/repo/pull/123

`.stageignore`

Add a .stageignore file to your repo root to exclude files from the diff analysis. Uses .gitignore-style patterns, one per line:

# Build artifacts
build/**
dist/**

# Generated code
*.generated.ts

# But keep this one
!dist/important.js

Ignored files still appear in the "Other changes" chapter so nothing is silently hidden. Comments (#), blank lines, and negation patterns (!) are supported — last matching pattern wins.

Stage CLI

License

MIT

Extension points exported contracts — how you extend this code

FileContent (Interface)

(no doc)

packages/types/src/diff.ts

ParseDiffFile (Interface)

(no doc)

packages/cli/src/diff-parser.ts

(no doc)

packages/web/src/router.tsx

DiffResponse (Interface)

(no doc)

packages/types/src/diff.ts

ParseDiffChunk (Interface)

(no doc)

packages/cli/src/diff-parser.ts

FileRoutesByFullPath (Interface)

(no doc)

packages/web/src/routeTree.gen.ts

ParseDiffChange (Interface)

(no doc)

packages/cli/src/diff-parser.ts

FileRoutesByTo (Interface)

(no doc)

packages/web/src/routeTree.gen.ts

Core symbols most depended-on inside this repo

called by 121

packages/web/src/lib/utils.ts

writeJson

called by 60

packages/cli/src/routes/json.ts

getDb

called by 54

packages/cli/src/db/client.ts

insertChaptersFile

called by 36

packages/cli/src/runs/import-chapters.ts

parseGitDiff

called by 23

packages/cli/src/diff-parser.ts

useFileCollapseState

called by 19

packages/web/src/lib/use-file-collapse-state.ts

closeDb

called by 18

packages/cli/src/db/client.ts

jsonFetch

called by 17

packages/web/src/lib/use-view-state.ts

Shape

Function 629

Interface 144

Class 2

Method 1

Languages

TypeScript100%

Modules by API surface

packages/web/src/components/chapter/hunk-highlight-overlay.tsx38 symbols

packages/cli/src/git.ts33 symbols

packages/web/src/lib/use-view-state.ts19 symbols

packages/web/src/lib/use-text-selection.ts16 symbols

packages/cli/src/diff-parser.ts16 symbols

packages/cli/src/github/pull-request.ts15 symbols

packages/web/src/components/files/file-diff-list.tsx14 symbols

packages/web/src/lib/pull-request-mutations.ts13 symbols

packages/cli/src/routes/view-state.ts13 symbols

packages/cli/src/server.ts12 symbols

packages/web/src/components/ui/markdown.tsx11 symbols

packages/web/src/components/ui/alert-dialog.tsx11 symbols

For agents

$ claude mcp add stage-cli \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact