---
slug: "pjlee-pi-package"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/ins429/agent-stuff@main/README.md"
repo: "https://github.com/ins429/agent-stuff"
source_file: "README.md"
branch: "main"
---
# Agent Stuff

A [pi package](https://github.com/badlogic/pi-mono) containing skills, extensions, themes, and prompt commands for the pi coding agent.

Originally inspired by [`mitsupi`](https://github.com/mitsuhiko/agent-stuff) and many stuff copied from it.

## Skills

Skill files live in the [`skills/`](https://github.com/ins429/agent-stuff/tree/HEAD/skills) folder:

| Skill | Description |
|-------|-------------|
| [`/commit`](https://github.com/ins429/agent-stuff/tree/HEAD/skills/commit) | Git commits using concise Conventional Commits-style subjects |
| [`/update-changelog`](https://github.com/ins429/agent-stuff/tree/HEAD/skills/update-changelog) | Update changelogs with notable user-facing changes |
| [`/ghidra`](https://github.com/ins429/agent-stuff/tree/HEAD/skills/ghidra) | Reverse engineer binaries using Ghidra's headless analyzer |
| [`/github`](https://github.com/ins429/agent-stuff/tree/HEAD/skills/github) | Interact with GitHub via the `gh` CLI (issues, PRs, runs, APIs) |
| [`/web-browser`](https://github.com/ins429/agent-stuff/tree/HEAD/skills/web-browser) | Browse the web by remote controlling Chrome via CDP |
| [`/tmux`](https://github.com/ins429/agent-stuff/tree/HEAD/skills/tmux) | Remote control tmux sessions with keystrokes and pane scraping |
| [`/sentry`](https://github.com/ins429/agent-stuff/tree/HEAD/skills/sentry) | Fetch and analyze Sentry issues, events, and logs |
| [`/pi-share`](https://github.com/ins429/agent-stuff/tree/HEAD/skills/pi-share) | Load and parse session transcripts from pi-share URLs |
| [`/frontend-design`](https://github.com/ins429/agent-stuff/tree/HEAD/skills/frontend-design) | Design and implement distinctive frontend interfaces |

## Extensions

Extensions live in the [`pi-extensions/`](https://github.com/ins429/agent-stuff/tree/HEAD/pi-extensions) folder:

| Extension | Description |
|-----------|-------------|
| [`answer.ts`](https://github.com/ins429/agent-stuff/blob/HEAD/pi-extensions/answer.ts) | `/answer` command — extracts questions from the last assistant message and presents an interactive TUI to answer them one by one |
| [`control.ts`](https://github.com/ins429/agent-stuff/blob/HEAD/pi-extensions/control.ts) | Inter-session communication via Unix domain sockets (`--session-control` flag). Send messages, get summaries, and coordinate between running pi sessions |
| [`cwd-history.ts`](https://github.com/ins429/agent-stuff/blob/HEAD/pi-extensions/cwd-history.ts) | Seeds the prompt editor history with recent prompts from current and past sessions in the same working directory |
| [`files.ts`](https://github.com/ins429/agent-stuff/blob/HEAD/pi-extensions/files.ts) | `/files` and `/diff` commands — file browser merging git status with session-referenced files, plus reveal/open/edit/diff actions |
| [`loop.ts`](https://github.com/ins429/agent-stuff/blob/HEAD/pi-extensions/loop.ts) | `/loop` command — starts a follow-up loop that keeps sending a prompt until the agent calls `signal_loop_success` |
| [`notify.ts`](https://github.com/ins429/agent-stuff/blob/HEAD/pi-extensions/notify.ts) | Sends native desktop notifications when the agent finishes (OSC 777, works in Ghostty, iTerm2, WezTerm) |
| [`review.ts`](https://github.com/ins429/agent-stuff/blob/HEAD/pi-extensions/review.ts) | `/review` command and Ctrl+R shortcut — code review for PRs, branches, uncommitted changes, or specific commits |
| [`todos.ts`](https://github.com/ins429/agent-stuff/blob/HEAD/pi-extensions/todos.ts) | File-backed todo manager with a TUI for listing, creating, and editing todos (stored in `.pi/todos/`) |
| [`whimsical.ts`](https://github.com/ins429/agent-stuff/blob/HEAD/pi-extensions/whimsical.ts) | Replaces "Thinking..." with random phrases like "Reticulating splines...", "Consulting the void...", etc. |

## Themes

Themes live in the [`pi-themes/`](https://github.com/ins429/agent-stuff/tree/HEAD/pi-themes) folder:

| Theme | Description |
|-------|-------------|
| [`nightowl.json`](https://github.com/ins429/agent-stuff/blob/HEAD/pi-themes/nightowl.json) | Night Owl color theme |

## Prompt Commands

Prompt template commands live in the [`commands/`](https://github.com/ins429/agent-stuff/tree/HEAD/commands) folder. Currently empty — add `.md` files here to register `/command` prompts.

## Publishing

This package is published to npm via GitHub Actions. To release:

1. Run `npm version <patch|minor|major>` to bump the version
2. Update `CHANGELOG.md` for the release
3. Commit and tag with `git tag <version>`
4. Push commits and tags: `git push && git push --tags`

The [npm-publish workflow](https://github.com/ins429/agent-stuff/blob/HEAD/.github/workflows/npm-publish.yml) triggers on version tags and publishes automatically.

## License

See [LICENSE](https://github.com/ins429/agent-stuff/tree/HEAD/LICENSE).