# Pi Notes

> Create or operate local product-namespaced Pi review documents that can send feedback turns back to the spawning Pi session.

- Skill: `joelhooks/pi-notes` (Agent Skill)
- Install (CLI): `npx skillmds@latest add joelhooks/pi-notes`
- Raw SKILL.md: https://api.skillmd.com/api/skills/joelhooks/pi-notes/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: joelhooks (https://skillmd.com/u/joelhooks)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/joelhooks/pi-notes

---


# pi-notes

Use this skill when creating, serving, reviewing, or debugging pi-notes review documents.

## Principles

- Treat product namespace as required.
- Prefer local `portless` URLs for stable access.
- Review docs should batch precise feedback and send it back to the spawning Pi session.
- Preserve source-grounded content law when reviewing source-derived docs.
- Keep UI hyper-readable, restrained, and keyboard-first.
- For diagrams, prefer the local `excalidraw-dag` skill: clean left-to-right DAGs, few boxes, legible labels, linked from Brain entries.

## References

- Extension source: `extensions/pi-notes/index.ts`
- Domain glossary: `.brain/areas/concepts.svx` (rendered through the pi-notes Document Host)
- Architecture/area notes: `.brain/areas/*.svx` and `.brain/resources/*.svx`; legacy `docs/project/context.md` is migration evidence only if present
- Architecture decision: `docs/adr/0001-pi-extension-local-review-sites.md`
- Diagram guidance: `skills/excalidraw-dag/SKILL.md`
- Diagram Brain entry: `.brain/resources/excalidraw-diagrams.svx` (`http://127.0.0.1:4188/notes/resources/excalidraw-diagrams`)
- Pi source/docs: `repos/pi-mono/`
- Effect source: `repos/effect/`
- Keystrok inspiration/license: `repos/keystrok/`