- TypeScript 95.6%
- JavaScript 3.4%
- CSS 0.5%
- Shell 0.4%
| audio | ||
| extensions | ||
| gnome-shell-extension | ||
| pi-web | ||
| skills | ||
| tests | ||
| .gitignore | ||
| AGENTS.md | ||
| package-lock.json | ||
| package.json | ||
| README.md | ||
| tsconfig.json | ||
pi-config
Personal super-package of custom pi extensions and skills. Maintain everything here, then install it on any machine with a single command.
Install
pi install https://git.findley.dev/david/pi-config
Update
pi update --extensions
Extensions
audio-notifications (extensions/audio-notifications.ts)
- Audio notifications for prompt send, agent question, and agent done.
- Use
/soundsfor status. - Use
/sounds onand/sounds offto toggle playback (session-local). - Set volume with
/sounds volume 0.5(0.0 to 1.0). - Linux playback tries
pw-play,paplay,ffplay, thenaplay; macOS triesafplay, thenffplay. - The
ui_prompt_startevent triggers agent question notification. - test with
node --test tests/audio-notifications.test.mjs
dictate (extensions/dictate.ts)
- Install sox package on system
- Set
DEEPGRAM_API_KEYenv var - Use alt+m to toggle dictation
- Use alt+n to discard dictation
web-search (extensions/web-search.ts)
- Get a kagi API token from https://kagi.com/api/keys. This is not the same as a person API token.
- Run
/kagi-tokenand paste the token.
muse (extensions/muse/)
Read-only Muse data tools, ported from musey-pi-durable: muse_db (app
Mongo, prod/staging), muse_bi (Postgres BI warehouse) and muse_telemetry
(telemetry Mongo, with a time guard on the 100M+ doc collections).
/muse-db auth [prod|staging],/muse-bi auth,/muse-telemetry auth— paste the URI / password into a masked prompt; the connection is tested, then saved to~/.pi/agent/muse-credentials.json(0600). No env vars./muse-<tool> statusshows what's configured (masked);logoutremoves it.
send-file (extensions/send-file/)
send_file attaches generated files (reports, CSVs, exports, etc.) for download
in pi-web. Ported from musey-pi; registered only in web/RPC sessions, not the
terminal or live-TUI mode. The web renders its result as a download card.
pi-web sets PI_WEB_ATTACHMENTS_DIR automatically to its resolved attachment
store, so files from other project directories are still downloadable. If the
old musey-pi send-file extension is configured separately, disable it to avoid
registering the same tool twice.
subagents (extensions/subagents/)
Background agents mirror the parent’s tools/model and report their answers back.
Use /subagents to list them, or /subagents <name> to watch one in the TUI.
- Child conversations survive parent restarts, extension reloads, and TUI/web
handoffs. Reopen the same parent session, then ask it to resume a named child;
the existing
subagent send(name, message)action continues its saved history. - Restored children are idle. Interrupted work is labelled, never automatically replayed. The parent learns about restored children on its next turn.
- Transcripts live under
<agentDir>/subagents/<parent-session-id>/, outside the normal session picker; references live in the parent JSONL. Keep both when moving/backing up a session. Parent forks/clones copy child conversations. - Tree navigation restores the roster for that parent branch, but does not rewind a child’s independent conversation. No-session parents and foreground loop subtasks stay ephemeral.
- Finalized messages survive; in-flight streaming and undelivered queued messages do not. Tools interrupted by a restart may already have changed files or other external state. Old answers are not automatically redelivered.
- Previously lost in-memory children cannot be recovered retroactively.
fzf-files (extensions/fzf-files/)
- Requires fd and fzf
pi-web (pi-web/)
Browser UI for pi sessions on this workstation (formerly musey-pi-web). Not
loaded by pi — run it separately with pi-web/start.sh; see pi-web/README.md.