Agent Stuff

Armin's personal Pi Coding Agent package: reusable skills, extensions, prompt commands, themes, and a few supporting utilities that I use across projects.

The package is published to npm as mitsupi. The Pi package manifest in package.json exports:

• extensions as Pi extensions
• skills as agent skills
• themes as Pi themes
• commands as prompt commands

Most items are tuned for my workflow and environment, so expect to adjust paths, credentials, or defaults before reusing them elsewhere.

Prompt Commands

Prompt commands live in commands:

• /discuss - Planning interviewer mode. It inspects the project first, asks focused questions in short rounds, and stops once the plan is clear enough to implement.

Skills

Skills live in skills. Each skill has a SKILL.md plus any helper scripts it needs.

• /anachb - Query Austrian public transport via VOR AnachB: station search, real-time departures, routes, and disruptions.
• /apple-mail - Search and read Apple Mail's local storage, including raw messages and attachment extraction.
• /commit - Guidance for making concise git commits with good subjects and bodies.
• /frontend-design - Create distinctive, production-ready frontend UI with strong visual direction.
• /ghidra - Run Ghidra headless analysis for binaries, functions, strings, symbols, call graphs, and decompilation.
• /github - Use the gh CLI for GitHub issues, pull requests, runs, and API queries.
• /google-workspace - Access Drive, Docs, Calendar, Gmail, Sheets, Slides, Chat, and People APIs through local helper scripts.
• /librarian - Cache and refresh remote git repositories under ~/.cache/checkouts/<host>/<org>/<repo>.
• /native-web-search - Trigger native web search with concise summaries and source URLs.
• /oebb-scotty - Plan Austrian rail journeys and check ÖBB Scotty station departures, arrivals, trips, and disruptions.
• /openscad - Create/render OpenSCAD models, preview angles, extract parameters, validate syntax, and export STL files.
• /pi-share - Fetch and parse shared Pi session transcripts from pi-share URLs.
• /sentry - Fetch and analyze Sentry issues, events, transactions, and logs.
• /summarize - Convert URLs or local documents to Markdown with uvx markitdown, optionally summarizing them.
• /tmux - Remote-control tmux sessions for interactive CLIs by sending keystrokes and scraping pane output.
• /update-changelog - Guidance for updating changelogs with notable user-facing changes.
• /uv - Prefer uv for Python projects, scripts, dependencies, and builds.
• /web-browser - Automate Chrome/Chromium through the Chrome DevTools Protocol.

Extensions

Pi extensions live in extensions:

• answer.ts - /answer plus ctrl+. to extract questions from the last assistant message and answer them in an interactive Q&A flow.
• btw.ts - /btw side-chat popover for quick tangential questions, with thread restore/reset behavior.
• control.ts - Session control sockets, /control-sessions, and the send_to_session / list_sessions tools for communicating with other live Pi sessions.
• files.ts - /files browser with git status and session references, plus shortcuts to browse, reveal, and Quick Look referenced files.
• goal.ts - /goal long-running objective mode with automatic continuation and the get_goal, create_goal, and update_goal tools.
• multi-edit.ts - Enhanced edit tool supporting single edits, batch multi edits, and Codex-style patches with preflight validation.
• no-sleep.ts - /no-sleep macOS caffeinate integration to prevent sleep while an agent or session is active.
• notify.ts - Native terminal desktop notification when the agent finishes and is ready for input.
• prompt-editor.ts - /mode, ctrl+shift+m, and ctrl+space prompt-mode selector with persistence and shortcuts.
• review.ts - /review and /end-review for reviewing uncommitted changes, branches, commits, PRs, or folder snapshots.
• session-breakdown.ts - /session-breakdown TUI for 7/30/90-day session usage, token, model, and cost analysis.
• split-fork.ts - /split-fork to branch the current session into a new Pi process in a right-hand Ghostty split.
• todos.ts - /todos TUI plus todo tool for file-backed tasks in .pi/todos or PI_TODO_PATH.
• trust-github-repos.ts - Automatically trusts GitHub checkouts owned by earendil-works or mitsuhiko.
• uv.ts - Replaces the bash tool with a uv-aware version that injects Python command shims and blocks common non-uv workflows.
• whimsical.ts - Replaces the default thinking/status text with random whimsical phrases.

Themes

Custom themes live in themes:

• dayowl.json - Light Day Owl-inspired theme.
• modern-dark.json - Dark orange/blue-gray theme.
• nightowl.json - Night Owl-inspired theme.

Support Files and Utilities

• intercepted-commands - Shell shims for pip, pip3, poetry, python, and python3. These are used by extensions/uv.ts to nudge agents toward uv.
• analyze-edits.py - uv run script for analyzing edit tool usage in Pi session JSONL files.
• .github/workflows/npm-publish.yml - Publishes the npm package on semver tags when the tag matches package.json.

Development

Install dependencies with npm:

npm install

Release notes for this repository are in CHANGELOG.md. The package currently relies on Pi to load TypeScript extensions directly from the paths declared in package.json.