---
slug: "geminixiang-pi-diff-geminixiang"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/geminixiang/pi-stuff@main/README.md"
repo: "https://github.com/geminixiang/pi-stuff"
source_file: "README.md"
branch: "main"
---
# pi-stuff

Monorepo for `@geminixiang` packages that extend the [Pi coding agent](https://github.com/badlogic/pi-mono).

## Packages

| Package | Version | Description |
| --- | --- | --- |
| [`@geminixiang/pi-simplify`](https://github.com/geminixiang/pi-stuff/tree/HEAD/packages/pi-simplify) | [![npm](https://img.shields.io/npm/v/%40geminixiang%2Fpi-simplify)](https://www.npmjs.com/package/@geminixiang/pi-simplify) | Review changed code for reuse, quality, and efficiency. It also includes the `/code-smell` workflow. |
| [`@geminixiang/pi-cicd-status`](https://github.com/geminixiang/pi-stuff/tree/HEAD/packages/pi-cicd-status) | [![npm](https://img.shields.io/npm/v/%40geminixiang%2Fpi-cicd-status)](https://www.npmjs.com/package/@geminixiang/pi-cicd-status) | Inspect CI/CD status through GitHub check runs and workflow runs. |
| [`@geminixiang/pi-diff`](https://github.com/geminixiang/pi-stuff/tree/HEAD/packages/pi-diff) | [![npm](https://img.shields.io/npm/v/%40geminixiang%2Fpi-diff)](https://www.npmjs.com/package/@geminixiang/pi-diff) | Open a GitHub-like Git diff viewer in the browser. |
| [`@geminixiang/pi-mermaid`](https://github.com/geminixiang/pi-stuff/tree/HEAD/packages/pi-mermaid) | [![npm](https://img.shields.io/npm/v/%40geminixiang%2Fpi-mermaid)](https://www.npmjs.com/package/@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.

```sh
npm install
npm run verify
npm run pack:check
```

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

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

## Release skill

The repository includes a project-local [`release` skill](https://github.com/geminixiang/pi-stuff/blob/HEAD/.pi/skills/release/SKILL.md). 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:

```text
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.