paseo-graphite

A trusted local Paseo 0.8 plugin that shows the real Graphite stack for each workspace and tells you whether a PR needs action, is ready to merge, is waiting, or is done.

The stack comes from the Graphite CLI in the workspace. GitHub only enriches those Graphite branches with reviews, unresolved threads, checks, and mergeability. The plugin does not infer Graphite membership from GitHub PR base branches.

Requirements

• Paseo 0.8+
• git
• Graphite CLI (gt) initialized in the repository
• authenticated GitHub CLI (gh) for live PR status

Use

• Open Graphite PRs from Paseo's left sidebar or Command Center for an inbox across active workspaces, grouped into needs-attention, approved, waiting, and completed sections.
• Press the Stack N / Stack N · Fix M workspace header button.
• Press the matching composer pill beside Tasks and Subagents.
• Run /pr-stack in an agent composer to open the Explorer panel.
• Press Fix All to create a separate agent in the workspace using the latest agent's provider configuration. If review feedback is present, its prompt starts with your existing /fix-pr workflow. The plugin does not register or intercept /fix-pr.

The workspace panel is intentionally dense: each PR is a compact row with action state, resolved/total review-thread count, check count, and a small Graphite link. GitHub links and comment bodies are omitted.

Install

Install from npm on Paseo 0.9.0 or newer:

paseo plugin install npm:paseo-graphite

Paseo 0.8 can install the same plugin from Git:

paseo plugin add tomgrin10/paseo-graphite

Develop

npm install
npm run verify
paseo plugin install "$PWD"
paseo plugin reload paseo-graphite
paseo plugin logs paseo-graphite

See PLAN.md for the product model and roadmap.