diff --git a/300 areas/350 AI/Pi Agent Extensions & Skills.md b/300 areas/350 AI/Pi Agent Extensions & Skills.md index 5825bfb..2bea217 100644 --- a/300 areas/350 AI/Pi Agent Extensions & Skills.md +++ b/300 areas/350 AI/Pi Agent Extensions & Skills.md @@ -109,7 +109,7 @@ pi → omni provider → POST /v1/chat/completions { model: "default-opencode-go | **@tintinweb/pi-tasks** | npm (global) | Task management with dependency tracking, auto-cascade, background process tracking, TaskExecute spawns subagents via RPC | | **gentle-engram** | `~/.agents` | Memory service connecting to engram via ENGRAM_URL. Replaces memory-vault. Session capture, compaction recovery | | **headroom-bridge** | `~/.agents` | `compress_for_agent` tool — compresses >20K chars via Headroom Docker on .13:8787. 60-95% token reduction | -| **pi-langfuse** | npm (project) | Langfuse LLM observability for pi — one trace per conversation, grouped by pi session, with tokens + cost. See [[#pi-langfuse — LLM Observability for Pi]] | +| **pi-langfuse** | `~/.agents` (vendored from npm 1.5.8, commit `bc91a15`) | Langfuse LLM observability for pi — one trace per conversation, grouped by pi session, with tokens + cost. Activate per project via `/config-add ext pi-langfuse`. See [[#pi-langfuse — LLM Observability for Pi]] | ### pi-subagents (@tintinweb) @@ -399,7 +399,7 @@ Sends pi's LLM traffic to Langfuse (self-hosted on .13:3001) for tracing, token | Aspect | Detail | |--------|--------| | **What it is** | pi extension (npm package `pi-langfuse` v1.5.8, by gooyoung) that captures pi runs — agent steps, LLM generations, tool calls, final output, usage, cost — into Langfuse | -| **Where it runs** | Per-project — enabled by adding `npm:pi-langfuse` to `/.pi/settings.json` `packages`. Keys read globally from `~/.pi/agent/pi-langfuse/config.json` | +| **Where it runs** | Per-project — vendored at `~/.agents/extensions/pi-langfuse/`, activated with `/config-add ext pi-langfuse` then `/reload`. Keys read globally from `~/.pi/agent/pi-langfuse/config.json` | | **Config file** | `~/.pi/agent/pi-langfuse/config.json` (mode 600): `{ "publicKey": "pk-lf-…", "secretKey": "sk-lf-…", "host": "http://192.168.20.13:3001" }` | | **Env var fallback** | `LANGFUSE_PUBLIC_KEY`, `LANGFUSE_SECRET_KEY`, `LANGFUSE_BASE_URL` (used only when config.json is missing/incomplete) | | **Commands** | `/langfuse-setup` (interactive key entry), `/langfuse-status` (show config state, masked keys, capture policy) | @@ -409,15 +409,14 @@ Sends pi's LLM traffic to Langfuse (self-hosted on .13:3001) for tracing, token ### Install (per project) -Add to the project's `.pi/settings.json`: +Run inside the target project folder (uses the standard `~/.agents` workflow — see the nixos-workflow skill): -```json -{ - "packages": ["npm:pi-langfuse"] -} +```text +/config-add ext pi-langfuse +/reload ``` -Restart pi — it installs the extension into `.pi/npm/` and picks up the config automatically. +pi installs the extension's npm dependencies automatically (deps are gitignored in `~/.agents`). ### Global install (all projects / machines)