No description
  • TypeScript 95.6%
  • JavaScript 3.4%
  • CSS 0.5%
  • Shell 0.4%
Find a file
2026-11-17 12:34:07 -06:00
audio Add audio notifications extension 2026-09-11 18:21:29 -05:00
extensions Add edit-guidance to discourge use of python heredocs to edit 2026-11-16 20:53:33 -06:00
gnome-shell-extension Add computer-use extension 2026-10-24 18:48:03 -05:00
pi-web Update pi-web to render codemode blocks 2026-11-17 12:34:07 -06:00
skills Add manage-with-me skill 2026-11-06 21:30:15 -06:00
tests Improve TUI subagents dialog UI 2026-10-14 15:00:41 -05:00
.gitignore Initial commit 2026-08-16 17:03:45 -05:00
AGENTS.md notifications: P5 docs — notifications/deploy/bind in AGENTS + READMEs, integration review + e2e notes, drop --no-caddy 2026-11-06 11:46:57 -06:00
package-lock.json calendar: P0 core — iCal/SQLite store, input parsing, approval contract 2026-11-05 21:55:54 -06:00
package.json notifications: P3 notify tool — fire-and-forget outbox enqueue, session link, heartbeat refusal, child exclusion 2026-11-06 11:29:08 -06:00
README.md Subagent persistence 2026-10-14 00:25:18 -05:00
tsconfig.json Initial commit 2026-08-16 17:03:45 -05:00

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 /sounds for status.
  • Use /sounds on and /sounds off to toggle playback (session-local).
  • Set volume with /sounds volume 0.5 (0.0 to 1.0).
  • Linux playback tries pw-play, paplay, ffplay, then aplay; macOS tries afplay, then ffplay.
  • The ui_prompt_start event 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_KEY env 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-token and 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> status shows what's configured (masked); logout removes 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.