From 36083b5c06d95f26192514ec77c800fec1b9f775 Mon Sep 17 00:00:00 2001 From: Bruno Garcia Date: Thu, 19 Feb 2026 11:33:18 -0500 Subject: [PATCH 1/2] docs: add pi setup instructions Pi discovers skills from .pi/skills/ and doesn't have built-in MCP config. Instead of a full agent definition, pi users add a symlink target to their agents.toml which creates .pi/skills/ -> .agents/skills/. Closes #25 Co-Authored-By: Claude Opus 4.6 Generated-By: pi 0.52.12 --- README.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/README.md b/README.md index 21153b7..0028f8d 100644 --- a/README.md +++ b/README.md @@ -161,6 +161,19 @@ agents = ["claude", "cursor"] | `vscode` | `.vscode` | `.vscode/mcp.json` | `.claude/settings.json` | | `opencode` | `.claude` | `opencode.json` | -- | +### Pi + +[Pi](https://github.com/badlogic/pi-mono) discovers skills from `.pi/skills/` rather than from the `agents` field. To set it up, add a symlink target to your `agents.toml`: + +```toml +[symlinks] +targets = [".pi"] +``` + +After running `dotagents install`, pi will read skills from `.pi/skills/ -> .agents/skills/`. + +Pi does not use dotagents for MCP configuration. If you use an MCP extension with pi, configure it separately via `.pi/mcp.json`. + ## MCP Servers Declare MCP servers once in `agents.toml` and dotagents generates the correct config file for each agent during `install` and `sync`. From 3d59f3ef0778d86a3888d16fe801d5f0545e5448 Mon Sep 17 00:00:00 2001 From: Bruno Garcia Date: Thu, 19 Feb 2026 11:39:02 -0500 Subject: [PATCH 2/2] address review: clarify Pi is not an agents target, fix capitalization Co-Authored-By: Claude Opus 4.6 Generated-By: pi 0.52.12 --- README.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 0028f8d..483fa17 100644 --- a/README.md +++ b/README.md @@ -163,16 +163,16 @@ agents = ["claude", "cursor"] ### Pi -[Pi](https://github.com/badlogic/pi-mono) discovers skills from `.pi/skills/` rather than from the `agents` field. To set it up, add a symlink target to your `agents.toml`: +[Pi](https://github.com/badlogic/pi-mono) discovers skills from `.pi/skills/`. It is not listed as an `agents` target, so instead add a symlink target to your `agents.toml`: ```toml [symlinks] targets = [".pi"] ``` -After running `dotagents install`, pi will read skills from `.pi/skills/ -> .agents/skills/`. +After running `dotagents install`, Pi will read skills from `.pi/skills/ -> .agents/skills/`. -Pi does not use dotagents for MCP configuration. If you use an MCP extension with pi, configure it separately via `.pi/mcp.json`. +Pi does not use dotagents for MCP configuration. If you use an MCP extension with Pi, configure it separately via `.pi/mcp.json`. ## MCP Servers