{
  "markdown": "# Agent Stuff\n\nArmin's personal [Pi Coding Agent](https://buildwithpi.ai/) package: reusable skills, extensions, prompt commands, themes, and a few supporting utilities that I use across projects.\n\nThe package is published to npm as [`mitsupi`](https://www.npmjs.com/package/mitsupi). The Pi package manifest in [`package.json`](package.json) exports:\n\n- [`extensions`](extensions) as Pi extensions\n- [`skills`](skills) as agent skills\n- [`themes`](themes) as Pi themes\n- [`commands`](commands) as prompt commands\n\nMost items are tuned for my workflow and environment, so expect to adjust paths, credentials, or defaults before reusing them elsewhere.\n\n## Prompt Commands\n\nPrompt commands live in [`commands`](commands):\n\n- [`/discuss`](commands/discuss.md) - Planning interviewer mode. It inspects the project first, asks focused questions in short rounds, and stops once the plan is clear enough to implement.\n\n## Skills\n\nSkills live in [`skills`](skills). Each skill has a `SKILL.md` plus any helper scripts it needs.\n\n- [`/anachb`](skills/anachb) - Query Austrian public transport via VOR AnachB: station search, real-time departures, routes, and disruptions.\n- [`/apple-mail`](skills/apple-mail) - Search and read Apple Mail's local storage, including raw messages and attachment extraction.\n- [`/commit`](skills/commit) - Guidance for making concise git commits with good subjects and bodies.\n- [`/frontend-design`](skills/frontend-design) - Create distinctive, production-ready frontend UI with strong visual direction.\n- [`/ghidra`](skills/ghidra) - Run Ghidra headless analysis for binaries, functions, strings, symbols, call graphs, and decompilation.\n- [`/github`](skills/github) - Use the `gh` CLI for GitHub issues, pull requests, runs, and API queries.\n- [`/google-workspace`](skills/google-workspace) - Access Drive, Docs, Calendar, Gmail, Sheets, Slides, Chat, and People APIs through local helper scripts.\n- [`/librarian`](skills/librarian) - Cache and refresh remote git repositories under `~/.cache/checkouts/<host>/<org>/<repo>`.\n- [`/native-web-search`](skills/native-web-search) - Trigger native web search with concise summaries and source URLs.\n- [`/oebb-scotty`](skills/oebb-scotty) - Plan Austrian rail journeys and check ÖBB Scotty station departures, arrivals, trips, and disruptions.\n- [`/openscad`](skills/openscad) - Create/render OpenSCAD models, preview angles, extract parameters, validate syntax, and export STL files.\n- [`/pi-share`](skills/pi-share) - Fetch and parse shared Pi session transcripts from pi-share URLs.\n- [`/sentry`](skills/sentry) - Fetch and analyze Sentry issues, events, transactions, and logs.\n- [`/summarize`](skills/summarize) - Convert URLs or local documents to Markdown with `uvx markitdown`, optionally summarizing them.\n- [`/tmux`](skills/tmux) - Remote-control tmux sessions for interactive CLIs by sending keystrokes and scraping pane output.\n- [`/update-changelog`](skills/update-changelog) - Guidance for updating changelogs with notable user-facing changes.\n- [`/uv`](skills/uv) - Prefer `uv` for Python projects, scripts, dependencies, and builds.\n- [`/web-browser`](skills/web-browser) - Automate Chrome/Chromium through the Chrome DevTools Protocol.\n\n## Extensions\n\nPi extensions live in [`extensions`](extensions):\n\n- [`answer.ts`](extensions/answer.ts) - `/answer` plus `ctrl+.` to extract questions from the last assistant message and answer them in an interactive Q&A flow.\n- [`btw.ts`](extensions/btw.ts) - `/btw` side-chat popover for quick tangential questions, with thread restore/reset behavior.\n- [`continue.ts`](extensions/continue.ts) - `shift+option+enter` sends `continue` only when the agent is stopped.\n- [`control.ts`](extensions/control.ts) - Session control sockets, `/control-sessions`, and the `send_to_session` / `list_sessions` tools for communicating with other live Pi sessions.\n- [`files.ts`](extensions/files.ts) - `/files` browser with git status and session references, plus shortcuts to browse, reveal, and Quick Look referenced files.\n- [`goal.ts`](extensions/goal.ts) - `/goal` long-running objective mode with automatic continuation and the `get_goal`, `create_goal`, and `update_goal` tools.\n- [`unified-edit.ts`](extensions/unified-edit.ts) - Replaces `edit` with a single text payload supporting marked row edit scripts and Codex-style patches with preflight validation.\n- [`no-sleep.ts`](extensions/no-sleep.ts) - `/no-sleep` macOS `caffeinate` integration to prevent sleep while an agent or session is active.\n- [`notify.ts`](extensions/notify.ts) - Native terminal desktop notification when the agent finishes and is ready for input.\n- [`prompt-editor.ts`](extensions/prompt-editor.ts) - `/mode`, `ctrl+shift+m`, and `ctrl+space` prompt-mode selector with persistence and shortcuts.\n- [`review.ts`](extensions/review.ts) - `/review` and `/end-review` for reviewing uncommitted changes, branches, commits, PRs, or folder snapshots.\n- [`session-breakdown.ts`](extensions/session-breakdown.ts) - `/session-breakdown` TUI for 7/30/90-day session usage, token, model, and cost analysis.\n- [`split-fork.ts`](extensions/split-fork.ts) - `/split-fork` to branch the current session into a new Pi process in a right-hand Ghostty split.\n- [`subagent.ts`](extensions/subagent.ts) - Serial `subagent` tool that runs one observable Pi child at a time in tmux; attach with the printed `pi --attach-subagent …` command.\n- [`todos.ts`](extensions/todos.ts) - `/todos` TUI plus `todo` tool for file-backed tasks in `.pi/todos` or `PI_TODO_PATH`.\n- [`trust-github-repos.ts`](extensions/trust-github-repos.ts) - Automatically trusts GitHub checkouts owned by `earendil-works` or `mitsuhiko`.\n- [`uv.ts`](extensions/uv.ts) - Replaces the bash tool with a `uv`-aware version that injects Python command shims and blocks common non-`uv` workflows.\n- [`whimsical.ts`](extensions/whimsical.ts) - Replaces the default thinking/status text with random whimsical phrases.\n\n## Themes\n\nCustom themes live in [`themes`](themes):\n\n- [`dayowl.json`](themes/dayowl.json) - Light Day Owl-inspired theme.\n- [`modern-dark.json`](themes/modern-dark.json) - Dark orange/blue-gray theme.\n- [`nightowl.json`](themes/nightowl.json) - Night Owl-inspired theme.\n\n## Support Files and Utilities\n\n- [`intercepted-commands`](intercepted-commands) - Shell shims for `pip`, `pip3`, `poetry`, `python`, and `python3`. These are used by [`extensions/uv.ts`](extensions/uv.ts) to nudge agents toward `uv`.\n- [`analyze-edits.py`](analyze-edits.py) - `uv run` script for analyzing `edit` tool usage in Pi session JSONL files.\n- [`.github/workflows/npm-publish.yml`](.github/workflows/npm-publish.yml) - Publishes the npm package on semver tags when the tag matches `package.json`.\n\n## Development\n\nInstall dependencies with npm:\n\n```sh\nnpm install\n```\n\nRelease notes for this repository are in [`CHANGELOG.md`](CHANGELOG.md). The package currently relies on Pi to load TypeScript extensions directly from the paths declared in [`package.json`](package.json).\n",
  "bytes": 7017,
  "sha": "a8f2a3bfd1f65f4406e861bb92b2cbdede8653a264cd209937cbbe7cbf800803",
  "repo_slug": "mitsuhiko/agent-stuff",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_mitsuhiko_agent_stuff_skills_improve_ski_a2851e77/readme"
}