howaboua-pi-stuff
A monorepo of extensions and skills by yours truly.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/IgorWarzocha/howaboua-pi-stuff with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/IgorWarzocha/howaboua-pi-stuff'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/igorwarzocha--howaboua-pi-stuff)HTML
<a href="/listings/igorwarzocha--howaboua-pi-stuff"><img src="/api/listings/igorwarzocha--howaboua-pi-stuff/badge.svg" alt="findsafeskills safety rating" /></a>Install
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 137 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- # Howaboua Pi Stuff
- The Pi extensions and skills I use to keep long agent sessions useful without building a fake operating system around them.
- Published packages can be installed individually or in a general-purpose bundle. Pick only what you need. Revolutionary stuff. A table.
- Pi packages run with your local permissions. You can obviously trust me, a stranger on the internet with a folder called `pi-stuff`, but read the source before installing it anyway.
- ## Bundles
- | Package | Includes | Deliberate exclusions |
- |---|---|---|
- | [`@howaboua/pi-stuff`](./packages/pi-stuff) | 13 general extensions and 15 shareable skills | Agent Comms, Browser, Sites, Observatory, Sandbox, Codex extensions, nested AGENTS loader and Omarchy support |
- | [`@howaboua/pi-extensions`](./packages/pi-extensions) | 13 general extensions | Agent Comms, Browser, Sites, Observatory, Sandbox, Codex extensions and nested AGENTS loader |
- | [`@howaboua/pi-skills`](./packages/pi-skills) | 15 shareable skills | Omarchy support |
- ```bash
- pi install npm:@howaboua/pi-stuff
- # or
- pi install npm:@howaboua/pi-extensions
- pi install npm:@howaboua/pi-skills
- ```
- `pi-codex-conversion` is separate because it changes Pi's tool surface for GPT/Codex models. `pi-codex-web-run` and `pi-codex-imagegen` are separate because they use Codex endpoints and login. `omarchy-help` is separate because it targets Arch desktops configured with Omarchy.
- Install `pi-browser` separately for logged-in browser control. The standalone `pi-subdir-agents` loader is also opt-in.
- [Agent Comms](./packages/pi-agent-comms) combines session notes, context rollover and agent boards in one separate package. `/notes` and `/board` open its two settings tabs; the Board tab opens the browser viewer. This consolidation is not published yet. Existing Shepherdr users need the coordinated bridge update before replacing the old Notes and Board packages.
- [Notes Compaction](./packages/pi-notes-compaction) and [Agent Board](./packages/pi-agent-board) remain maintained standalone alternatives and receive the same shared improvements. They are not deprecated. Do not load either alongside Agent Comms.
- Install `pi-observatory` separately for local session usage, tool outcomes and custom collector dashboards. `/observatory` opens the viewer; `/observatory agent <scope>` asks your current agent to investigate recorded evidence.
- `pi-sandbox` and `pi-chatgpt-sites` are also separate installs for local VMs and app previews, and ChatGPT Sites management.
- Install `pi-codex-guardian` separately for tool-call approval reviews. It requires a ChatGPT-backed Codex model and blocks tools when a review cannot complete.
- ## Extensions
- | Package | What it adds |
- |---|---|
- | [`pi-agent-comms`](./packages/pi-agent-comms) | Session notes, shared-agent history, context rollover and agent boards with a read-only browser viewer |
- | [`pi-notes-compaction`](./packages/pi-notes-compaction) | Standalone checkpoints, searchable session history and context rollover |
- | [`pi-agent-board`](./packages/pi-agent-board) | Standalone agent boards with a read-only browser viewer |
- | [`pi-ask`](./packages/pi-ask) | Interactive user decisions, review triage, and human handoffs |
- | [`pi-auto-trees`](./packages/pi-auto-trees) | `/marker` and `/end` for rolling completed work into a compact branch summary |
- | [`pi-better-skills-tool`](./packages/pi-better-skills-tool) | Progressive skill discovery in normal Pi, Code Mode, and Notebook Mode |
- | [`pi-browser`](./packages/pi-browser) | Logged-in browser control with local CDP sessions and SSH host routing |
- | [`pi-cache-hit-predictor`](./packages/pi-cache-hit-predictor) | Inline prompt-cache hit predictions when switching models or reasoning levels |
- | [`pi-chatgpt-sites`](./packages/pi-chatgpt-sites) | ChatGPT Sites management, committed-source saves and deployment |
- | [`pi-codex-conversion`](./packages/pi-codex-conversion) | Codex-shaped shell, patch, image inspection, and Code Mode tools for GPT/Codex models |
- | [`pi-codex-guardian`](./packages/pi-codex-guardian) | Guardian approval reviews before tool execution in native Pi, Code Mode, and Notebook Mode |
- | [`pi-gippity-control`](./packages/pi-gippity-control) | Realtime voice and LAN remote control for any Pi model |
- | [`pi-github-watch`](./packages/pi-github-watch) | Opt-in notifications when GitHub issue or pull request comments arrive |
- | [`pi-grok-realtime`](./packages/pi-grok-realtime) | Grok voice with Pi doing the work, local and browser dictation, and custom voice tools |
- | [`pi-gpt-switcher`](./packages/pi-gpt-switcher) | `/sol`, `/luna` and `/astra` shortcuts for Codex models with configurable reasoning defaults |
- | [`pi-codex-imagegen`](./packages/pi-codex-imagegen) | Codex image generation and editing in normal Pi, Code Mode, and Notebook Mode |
- | [`pi-observatory`](./packages/pi-observatory) | Local session usage and outcome dashboard, custom collectors and on-demand agent investigations |
- | [`pi-pet`](./packages/pi-pet) | Animated companion miniapps for GipPity Remote |
- | [`pi-sandbox`](./packages/pi-sandbox) | Persistent local VMs, guest commands, supervised services and app previews |
- | [`pi-shepherdr`](./packages/pi-shepherdr) | Herdr-native multi-agent orchestration |
- | [`pi-smart-btw`](./packages/pi-smart-btw) | Async side-session questions with explicit injection into the main chat |
- | [`pi-subagent-review`](./packages/pi-subagent-review) | `/review` through an isolated review subagent |
- | [`pi-subdir-agents`](./packages/pi-subdir-agents) | Nested `AGENTS.md` context during repository discovery |
- | [`pi-suggestions`](./packages/pi-suggestions) | Opt-in next-prompt drafts with `/suggestions` model settings |
- | [`pi-unicode-charts`](./packages/pi-unicode-charts) | Terminal-native Unicode charts for Pi Markdown |
- | [`pi-codex-web-run`](./packages/pi-codex-web-run) | Codex web search and navigation in normal Pi, Code Mode, and Notebook Mode |
- ## Skills
- | Package | Use it for |
- |---|---|
- | [`pi-skill-chrome-cdp`](./packages/pi-skill-chrome-cdp) | Inspecting and controlling a local Chrome-family browser through CDP |
- | [`pi-skill-code`](./packages/pi-skill-code) | Reviewing, changing, researching, and delivering maintained code |
- | [`pi-skill-foundations`](./packages/pi-skill-foundations) | Scoped agent guidance, clear communication, and reusable skill maintenance |
- | [`pi-skill-harness-and-agent-engineering`](./packages/pi-skill-harness-and-agent-engineering) | Diagnosing, designing, auditing, and calibrating agent harnesses |
- | [`pi-skill-omarchy-help`](./packages/pi-skill-omarchy-help) | User-level maintenance for Arch desktops configured with Omarchy |
- Pi discovers installed skills automatically and loads them when a task matches. Use `/skill:<name>` when you want to invoke one explicitly.
- ## Source-only extensions
- [`pi-chill`](./packages/pi-chill) folds routine tool activity into expandable progress blocks. It is a customisable starting point, installed from a checkout rather than npm, and is not included in the bundles.
- ## Herdr apps
- These apps run alongside Herdr, separate from the npm bundles. Each README covers requirements, installation and everyday use.
- | App | What it does |
- |---|---|
- | [Herdr Voice](./apps/herdr-voice) | Use this computer's microphone and speakers with local or remote Pi sessions through a native panel |
- | [Herdr State](./apps/herdr-state) | Manually save Herdr layouts and exact agent conversations, then restore them after a reboot without submitting new tasks |
- ## Build an integration
- The [extension API guide](./docs/extension-apis.md) covers Board and Notes with other subagent extensions, PCC tool and context APIs, voice tools, and browser miniapps. It includes lifecycle diagrams, public contracts and small integration examples.
- [How we test changes in a sandbox](./docs/e2e-sandboxing-test-procedure/) explains our reviewer workflow, model and provider comparisons, and headless application checks.
- ## Preview releases
- The `core` and `dev` npm tags are opt-in test builds. They do not change `latest` or update the bundles. For example:
- ```sh
- pi install npm:@howaboua/pi-shepherdr@core
- ```
- Use `@latest` instead to return to the stable package. Restart participating Pi sessions after changing versions. The published Shepherdr Core preview requires Herdr Core 0.1.18+, Pi 1.5+, Node.js 22.18+ and, for shared Notes, Notes Compaction 0.0.15+. It does not include the Agent Comms bridge update. Keep its existing Notes package until the coordinated update is available.
- <details>
- <summary>Publish a preview</summary>
- From the reviewed commit, push an explicit tag for one package:
- ```sh
- tag="core/pi-shepherdr/$(git rev-parse --short=12 HEAD)"
- git tag "$tag"
- git push origin "refs/tags/$tag"
- ```
- Use `dev/<package>/<commit>` for the `dev` channel. GitHub Actions runs the selected package's publish hooks and publishes only that package. Its temporary version uses the next patch number plus the channel, workflow run, attempt and commit. Source versions, lockfiles and changesets are not committed or consumed. Stable releases still follow the Changesets workflow on `main`.
- </details>
- ## Changelog
- See [CHANGELOG.md](./CHANGELOG.md). Package-level changelogs remain beside packages that have them.
- Extension updates use Pi 1.5's native notices on the next fresh launch. The first launch records installed versions silently. Use `collapseChangelog` in Pi's settings for condensed notices. Bundles show their combined changelog rather than separate notices for each bundled extension. Direct extension-file loads do not show package update notices. `/changelog` shows Pi's own history; use the links above for package history.
- The old `howaboua-pi-stuff-changelog.json` state and its `suppress` preference are no longer read or migrated. Set Pi's `collapseChangelog` preference yourself if you want condensed notices. This condenses updates rather than hiding them.
- ## License
- Individual packages include their own license files. They are MIT-licensed unless noted in the package directory.
- [](https://star-history.com/#IgorWarzocha/howaboua-pi-stuff&Date)
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.