sam-4screen-desktop 2026-5-16:13:31:54

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