pi-pack

Shareable extensions, prompts, skills, and themes for Pi.

Install

Home Manager

Use this method on Nix systems. The module deploys all resources and installs their required CLI packages.

Add the flake input:

{
  inputs.pi-pack.url = "github:fosskar/pi-pack";
}

Import and enable the Home Manager module:

{
  imports = [ inputs.pi-pack.homeModules.default ];
  programs.pi-pack.enable = true;
}

Pi package manager

Install all resources directly through Pi:

pi install git:github.com/fosskar/pi-pack

Pi records the package in ~/.pi/agent/settings.json. Use pi config to enable or disable individual resources.

The llm-wiki and sediment-memory extensions need extra CLI tools. See their entries under Extensions.

Use one skill from Nix

Home Manager can deploy one skill for another agent:

{
  home.file.".claude/skills/osm".source = "${inputs.pi-pack}/skills/osm";
}

Contents

Extensions

extension	description	commands
clipboard	Copy generated text through OSC52. Requires a terminal that accepts OSC52 clipboard writes.
herdr-session-name	Show the pi logo and session name as the agent name of the pi pane in Herdr. Active only inside a Herdr pane.
llm-wiki	Safely operate an existing Git-backed wiki without GitHub APIs. Requires git in PATH and a Git repository named llm-wiki. pi-pack does not create it.	/wiki-capture, /wiki-query, /wiki-observe, /wiki-lint, /wiki-status
oracle	Ask a second model to review, critique, or challenge a conclusion. Requires a second configured model provider.	/oracle
pi-to-PI	Rewrite standalone pi to PI in the system prompt for Anthropic models.
sediment-memory	Keep durable facts across sessions and recall them later. Requires sediment in PATH; Home Manager installs it, other Nix setups run nix profile install github:fosskar/pi-pack#sediment.	/memory
sketch	Open a browser sketch pad and send the result as image input. Requires a browser on the machine that runs Pi.	/sketch

Prompts

prompt	description	commands
commit	Split the current work into atomic commits with jj. It does not move bookmarks and does not push.	/commit
publish	Rebase on origin and push main to a remote.	/publish [remote]

Skills

skill	description
agents-md	Bootstrap an AGENTS.md or check one for stale claims.
handoff	Compact the current conversation into a handoff document.
huh	Give a clearer and simpler explanation of the last answer.
ops-review	Create a visual HTML report and examine a selected infrastructure risk.
osm	Find places, nearby points of interest, and public transport stops.
paperless	Search and read documents, receipts, invoices, and scans through a bounded read-only interface. Requires a paperless-ngx instance, PAPERLESS_URL, and PAPERLESS_API_TOKEN.
research	Send a background agent to investigate a question against primary sources and report cited findings in the conversation.
review-pong	Ask a second model to challenge review findings until the verdicts are stable.
security-audit	Audit a codebase for vulnerabilities and report confirmed findings with evidence and fixes. Original skill by cloudflare/security-audit-skill. Requires node.
show-me	Explain the current topic visually with diagrams, code-shape sketches, and focused HTML artifacts. Original skill by humanlayer/skills.
simplify	Refine recently modified code for clarity and consistency without changing behavior. Original agent by anthropics/claude-plugins-official.
teach	Teach the user a skill or concept in the current workspace.

Themes

Set "theme": "<name>" in settings.json.

theme	description
grey-amber	A dark grey theme with amber accents.
grey-teal	A dark grey theme with teal accents.

Develop

nix build .#     # packaged resources under share/pi-pack/
nix fmt          # nixfmt, Prettier, deadnix, statix
nix flake check  # builds, module evaluation, formatting, extension tests

Run nix flake show for the full output list.

Security

extensions execute code in the agent process. review them before installing from git.

skills can instruct an agent to run commands. review them before enabling in unattended services.

License

MIT