pi-napkin

🧻 Napkin integration for pi.

Install

npm i -g napkin-ai
pi install npm:pi-napkin

What you get

Extensions

napkin-context — On session start, injects the vault overview into the agent's context. Registers two tools:

• kb_search — Search the vault by keyword or topic
• kb_read — Read a note from the vault by name or path

napkin-distill — Automatic knowledge distillation. Runs on a timer (default: 60 min), forks the conversation, and uses a cheap model to extract structured notes into the vault. /distill triggers it manually.

Skill

The napkin skill gives the agent full CLI reference for napkin — all commands, flags, and patterns.

Vault resolution

Both extensions resolve the vault in this order:

1. Local project vault — walk up from cwd looking for .napkin/
2. Global fallback — read ~/.pi/agent/napkin.json for a default vault path

// ~/.pi/agent/napkin.json
{
  "vault": "~/.pi/agent/kb"
}

Local project vaults take priority when present.

Distillation config

Enable distillation in the vault's .napkin/config.json:

napkin --vault ~/.pi/agent/kb config set --key distill.enabled --value true

| Setting | Default | Description | |---------|---------|-------------| | distill.enabled | false | Enable automatic distillation | | distill.intervalMinutes | 60 | Timer interval | | distill.model.provider | "anthropic" | Model provider | | distill.model.id | "claude-sonnet-4-6" | Model for distillation |

License

MIT