From 37be2ff2be14af5fbba76c52c921f4942c0d62c8 Mon Sep 17 00:00:00 2001 From: Sam Rolfe Date: Sat, 16 May 2026 13:31:54 +1000 Subject: [PATCH] sam-4screen-desktop 2026-5-16:13:31:54 --- .../350 AI/Pi Agent Extensions & Skills.md | 35 +++++++++++++++++-- 1 file changed, 33 insertions(+), 2 deletions(-) diff --git a/300 areas/350 AI/Pi Agent Extensions & Skills.md b/300 areas/350 AI/Pi Agent Extensions & Skills.md index 294ee68..f07f51c 100644 --- a/300 areas/350 AI/Pi Agent Extensions & Skills.md +++ b/300 areas/350 AI/Pi Agent Extensions & Skills.md @@ -30,8 +30,9 @@ aliases: [] | **ask-user-question** | `~/.agents` | `ask_user_question` — LLM presents structured multiple-choice / text questions with keyboard UI | | **video-extract** | `~/.agents` | `video_extract` — extract frames from YouTube/local video + full Gemini analysis (requires ffmpeg + yt-dlp + GEMINI_API_KEY) | | **filechanges** | `~/.agents` | `/filechanges`, `/filechanges-accept`, `/filechanges-decline` — tracks every file LLM edits/writes, diff review, revert | -| **pi-subagents** (tintinweb v0.7.1) | `~/.agents` | Spawn child Pi agents for delegated tasks (scout, researcher, worker) | +| **pi-subagents** (nicopreme) | npm (global) | Spawn child Pi agents with chains, parallel execution, async dispatch. `/agents` command. Integrates with pi-prompt-template-model for delegated prompt execution | | **pi-prompt-template-model** | npm (global) | Model-switching prompt templates with frontmatter. See [[#Prompt Templates]] section below | +| **pi-mcp-adapter** | npm (global) | Single proxy tool (~200 tokens) replaces hundreds of MCP tool definitions. `/mcp` command for management. Lazy server connections | | **pi-graphify** | `~/.agents` | Knowledge graph tools: build, query, path tracing, explain, watch, add, update | | **plannotator** | `~/.agents` | Interactive plan review with browser UI, annotations, code review | | **caveman** | `~/.agents` | Ultra-compressed communication mode | @@ -118,6 +119,35 @@ Create a new `.md` file in `~/.pi/agent/prompts/` with frontmatter. The filename --- +## MCP Servers + +pi-mcp-adapter connects Pi to external services via the Model Context Protocol. + +**Config file:** `~/.config/mcp/mcp.json` + +```json +{ + "mcpServers": { + "filesystem": { + "command": "npx", + "args": ["-y", "@modelcontextprotocol/server-filesystem", "/home/sam"] + } + } +} +``` + +**Find MCP servers at:** +- [github.com/modelcontextprotocol/servers](https://github.com/modelcontextprotocol/servers) +- [smithery.ai](https://smithery.ai) — community registry + +**Usage:** +- `/mcp` — interactive panel to manage servers +- `mcp({ search: "..." })` — search available tools +- `mcp({ tool: "tool_name", args: '{}' })` — call a tool +- Servers are lazy (connect on first use, disconnect after 10 min idle) + +--- + ## Configuration Files ### Global (`~/.pi/agent/settings.json`) @@ -182,7 +212,8 @@ Create a new `.md` file in `~/.pi/agent/prompts/` with frontmatter. The filename ## Tasks -- [ ] Rebuild NixOS to activate Google provider + ffmpeg/yt-dlp + pi-prompt-template-model +- [ ] Rebuild NixOS to activate new packages (Google provider, ffmpeg/yt-dlp, pi-prompt-template-model, pi-mcp-adapter, pi-subagents) +- [ ] Add MCP servers to `~/.config/mcp/mcp.json` or `.mcp.json` as needed (Home Assistant, databases, etc.) - [ ] Run `/reload` in Pi to activate filechanges and new templates - [ ] Add more prompt templates to `~/.pi/agent/prompts/` as needed - [ ] Verify video-extract works with Gemini