Skip to content
Back to search

pi-config

My personal pi config.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/amosblomqvist--pi-config/badge.svg)](/listings/amosblomqvist--pi-config)

HTML

<a href="/listings/amosblomqvist--pi-config"><img src="/api/listings/amosblomqvist--pi-config/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 101 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # pi-config
  2. [![video](assets/thumbnail.png)](https://www.youtube.com/@EeroAlvar)
  3. My personal [pi](https://github.com/earendil-works/pi) configuration.
  4. The setup from [My Pi Setup After 6 Months](https://www.youtube.com/@EeroAlvar) (and its predecessor, [Pi Coding Agent Setup After 2 Months](https://www.youtube.com/watch?v=DWWrLlM3gwQ)).
  5. This is **not** meant to be installed as one big package. Browse the repo and copy the pieces you want into your own Pi config.
  6. Some extensions are big enough to live in their own repositories:
  7. - **[pi-interactive-subagents](https://github.com/amosblomqvist/pi-interactive-subagents)** — async, interactive subagents in multiplexer panes
  8. - **[pi-observational-memory](https://github.com/amosblomqvist/pi-observational-memory)** — tiered session memory with deterministic compaction
  9. - **[pi-dictate](https://github.com/amosblomqvist/pi-dictate)** — real-time voice dictation inside pi
  10. - **[learn](https://github.com/amosblomqvist/learn)** — my AI learning system, built on top of this config
  11. This repo contains everything else.
  12. ## Copy an extension
  13. Single-file extension:
  14. ```bash
  15. cp extensions/ask-user-question.ts ~/.pi/agent/extensions/
  16. ```
  17. Directory extension:
  18. ```bash
  19. cp -r extensions/browser ~/.pi/agent/extensions/
  20. ```
  21. If the copied extension has a `package.json`, install its deps:
  22. ```bash
  23. cd ~/.pi/agent/extensions/browser
  24. npm install
  25. ```
  26. Then restart pi or run `/reload`.
  27. ## Copy a skill
  28. ```bash
  29. cp -r skills/pdf-reader ~/.pi/agent/skills/
  30. ```
  31. Then restart pi or run `/reload`.
  32. ## Do not clone over your config
  33. Avoid cloning this repo directly into `~/.pi/agent` unless it is a fresh setup. If you already use pi, copy individual files/folders instead so you don't replace your own config.
  34. ## Contents
  35. ### Extensions
  36. - `ask-user-question.ts` — the agent asks you a question through a UI popup; popups from different extensions serialize via a shared UI lock
  37. - `bash-guard/` — hooks that catch dangerous bash commands before they run, with an on/off toggle
  38. - `browser/` — Playwright-driven headless Chromium the agent can drive (navigate, eval JS, inspect network/console, click, screenshot); off by default, enable with `/browser on`
  39. - `custom-header.ts` — the big capital Π header
  40. - `interactive-subagents/` — stub, see [pi-interactive-subagents](https://github.com/amosblomqvist/pi-interactive-subagents)
  41. - `observational-memory/` — stub, see [pi-observational-memory](https://github.com/amosblomqvist/pi-observational-memory)
  42. - `prompt-snippets/` — small, reusable behavior rules toggled onto a message before sending; reset after send
  43. - `web-fetch/` — fetch a URL and get clean markdown
  44. - `web-search/` — web search
  45. ### Skills
  46. - `analyze-sessions/` — Python scripts to query past pi sessions: cost rollups, prompt-pattern mining, session rendering
  47. - `pdf-reader/` — read PDFs (lecture notes, papers) into the context
  48. - `web-debug/` — a playbook for debugging frontend issues with the browser extension's tools
  49. - `youtube-transcript/` — fetch a YouTube video's title and transcript as JSON
  50. ### Deprecated
  51. `deprecated/` holds the extensions and skills from the two-month setup that are no longer in active use. They still work; they just didn't earn their place. Kept for reference.
  52. ## Dependencies
  53. Extension-local npm deps are kept with the extension. Run `npm install` only in copied extensions that include a `package.json`:
  54. - `bash-guard/`
  55. - `browser/` (also run `npx playwright install chromium` once)
  56. - `web-fetch/`
  57. Optional system tools:
  58. ```bash
  59. brew install yt-dlp ffmpeg
  60. ```
  61. Used by `youtube-transcript/`. Python 3 is needed for `youtube-transcript/` and `analyze-sessions/` (stdlib only).
  62. PDF reader setup after copying `skills/pdf-reader/`:
  63. ```bash
  64. python3 -m venv ~/.pi/agent/skills/pdf-reader/.venv
  65. ~/.pi/agent/skills/pdf-reader/.venv/bin/pip install -r ~/.pi/agent/skills/pdf-reader/requirements.txt
  66. ```

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.