pi-stuff

Monorepo for @geminixiang packages that extend the Pi coding agent.

Packages

Package	Version	Description
@geminixiang/pi-simplify		Review changed code for reuse, quality, and efficiency. It also includes the /code-smell workflow.
@geminixiang/pi-cicd-status		Inspect CI/CD status through GitHub check runs and workflow runs.
@geminixiang/pi-diff		Open a GitHub-like Git diff viewer in the browser.
@geminixiang/pi-mermaid		Render Mermaid diagrams as Unicode art inside the Pi terminal UI.

The standalone @geminixiang/pi-code-smell package is intentionally not part of this repository. Its functionality remains available through @geminixiang/pi-simplify.

Development

Requires Node.js 22.19 or newer.

npm install
npm run verify
npm run pack:check

Run a command for one package with npm's workspace flag:

npm test --workspace @geminixiang/pi-mermaid
npm run lint --workspace @geminixiang/pi-simplify

Release skill

The repository includes a project-local release skill. It prepares and publishes one workspace at a time using package-scoped release tags such as pi-mermaid@0.1.2, then verifies the trusted-publishing workflow and npm registry result.

Publishing

Each workspace is versioned and published independently. Create a GitHub release whose tag has the form <package>@<version>, for example:

pi-mermaid@0.1.2

The publish workflow verifies that the tag matches the selected workspace's package.json before publishing it to npm with provenance.