pi-munin

Pi extension that exposes Munin long-term memory as native Pi tools.

Install

Install the published package from npm:

pi install npm:@bacnh85/pi-munin

From this repository checkout, install only this extension package:

cd extensions/pi-munin
npm install
cd ../..

pi install ./extensions/pi-munin
# or test directly
pi -e ./extensions/pi-munin

The package manifest points Pi directly at ./index.ts, so published npm installs and local installs load the same extension entrypoint.

Configuration

The extension lazily discovers credentials on first tool use:

• MUNIN_API_KEY (required)
• MUNIN_PROJECT (required)
• MUNIN_BASE_URL (optional, defaults to https://munin.kalera.ai)

It also loads environment files without overriding existing environment values, in this order: current working directory .env.local, current working directory .env, Pi global config .env.local, and Pi global config .env. The Pi global config directory honors $PI_CODING_AGENT_DIR when set; otherwise it checks ~/.pi/agent and the compatibility path ~/.pi/agents.

Tools

Individual tools:

• munin_search
• munin_get
• munin_store
• munin_list
• munin_recent
• munin_delete
• munin_batch_store
• munin_versions
• munin_diff
• munin_rollback

Composite workflow tools:

• munin_recall — search and format top results with verification reminders.
• munin_capture — structured store with required type: and domain: tag validation.
• munin_summarize — recent + list + optional search condensed into project context.

Notes

• Treat retrieved memories as leads, not authority. Verify against current repository evidence before relying on them.
• Never store secrets, credentials, tokens, private keys, or sensitive connection strings.
• For E2EE projects, use the official Munin setup and environment variables; this extension relies on the official SDK/server protocol.

Troubleshooting

• Missing SDK dependency (Cannot find module '@kalera/munin-sdk'): when using this repository as a local Pi extension, install runtime dependencies in the extension directory with npm install --prefix extensions/pi-munin, then restart Pi or run /reload.
• Missing credentials: run /munin-status or set MUNIN_API_KEY and MUNIN_PROJECT.
• Auth/network/E2EE/stale-protocol errors are surfaced as actionable tool errors.
• If native tools are unavailable, use the memory skill CLI fallback.