add pi coding agent adapter (fixes #4)

Author: codejunkie99

README.md

@@ -10,8 +10,8 @@ Follow me on [@AV1DLIVE](https://twitter.com/AV1DLIVE) for updates/collabs on pr
 
 > **One brain, many harnesses.** A portable `.agent/` folder (memory + skills
 > + protocols) that plugs into Claude Code, Cursor, Windsurf, OpenCode,
-> OpenClient, Hermes, or a DIY Python loop, and keeps its knowledge when
-> you switch.
+> OpenClient, Hermes, Pi Coding Agent, or a DIY Python loop, and keeps
+> its knowledge when you switch.
 
 <p align="center">
   <img src="docs/demo.gif" alt="agentic-stack demo" width="880"/>
@@ -32,7 +32,7 @@ Based on the article:
 Every guide shows the folder structure. This repo gives you the folder
 structure **plus the files that actually go inside**: a working portable
 brain with five seed skills, four memory layers, enforced permissions, a
-nightly staging cycle, host-agent review tools, and adapters for seven
+nightly staging cycle, host-agent review tools, and adapters for eight
 harnesses.
 
 - **Memory** — `working/`, `episodic/`, `semantic/`, `personal/`. Each
@@ -79,7 +79,7 @@ brew install agentic-stack
 # drop the brain into any project — the onboarding wizard runs automatically
 cd your-project
 agentic-stack claude-code
-# or: cursor | windsurf | opencode | openclient | hermes | standalone-python
+# or: cursor | windsurf | opencode | openclient | hermes | pi | standalone-python
 ```
 
 ### Windows (PowerShell)
@@ -103,6 +103,7 @@ brew update && brew upgrade agentic-stack
 git clone https://github.com/codejunkie99/agentic-stack.git
 cd agentic-stack && ./install.sh claude-code         # mac / linux / git-bash
 # or on Windows PowerShell: .\install.ps1 claude-code
+# adapters: claude-code | cursor | windsurf | opencode | openclient | hermes | pi | standalone-python
 ```
 
 ## Onboarding wizard
@@ -209,6 +210,7 @@ adapters/                       # one small shim per harness
 ├── opencode/      (AGENTS.md + opencode.json)
 ├── openclient/    (system-prompt include)
 ├── hermes/        (AGENTS.md)
+├── pi/            (AGENTS.md + .pi/skills symlink)
 └── standalone-python/  (DIY conductor entrypoint)
 
 docs/                           # architecture, getting-started, per-harness
@@ -232,6 +234,7 @@ onboard_write.py                # atomic file write with backup
 | **OpenCode** | `AGENTS.md` + `opencode.json` | partial (permission rules) |
 | **OpenClient** | system-prompt include | varies by fork |
 | **Hermes Agent** | `AGENTS.md` (agentskills.io compatible) | partial (own memory) |
+| **Pi Coding Agent** | `AGENTS.md` + `.pi/skills/` | no (extension system) |
 | **Standalone Python** | `run.py` (any LLM) | yes (full control) |
 
 ## Seed skills

adapters/pi/AGENTS.md

@@ -0,0 +1,34 @@
+# AGENTS.md — Pi Coding Agent adapter for agentic-stack
+
+[Pi Coding Agent](https://github.com/badlogic/pi-mono) reads `AGENTS.md`
+(or `CLAUDE.md`) natively as workspace-level context. This file points
+it at the portable brain in `.agent/`.
+
+## Startup (read in order)
+1. `.agent/AGENTS.md` — the map
+2. `.agent/memory/personal/PREFERENCES.md` — user conventions
+3. `.agent/memory/semantic/LESSONS.md` — distilled lessons
+4. `.agent/protocols/permissions.md` — hard rules
+
+## Skills
+Pi scans `.pi/skills/` and `.agents/skills/` for skill packages. The
+install script symlinks `.pi/skills` → `.agent/skills` so every skill
+under the portable brain is visible to pi without duplication. Pi's
+skill format (frontmatter + body) is compatible with ours out of the
+box.
+
+## Memory discipline
+- Update `.agent/memory/working/WORKSPACE.md` as you work.
+- After significant actions, run
+  `python3 .agent/tools/memory_reflect.py <skill> <action> <outcome>`.
+- Never delete memory entries; archive only.
+
+## Hard rules
+- No force push to `main`, `production`, `staging`.
+- No modification of `.agent/protocols/permissions.md`.
+
+## Pi-specific extensions
+- System prompt override: put `.pi/SYSTEM.md` at project root if you
+  want to replace pi's default system prompt entirely.
+- Prompt templates go in `.pi/prompts/`.
+- TypeScript extensions go in `.pi/extensions/` (advanced).

adapters/pi/README.md

@@ -0,0 +1,40 @@
+# Pi Coding Agent adapter
+
+[Pi Coding Agent](https://github.com/badlogic/pi-mono) by Mario Zechner
+is a minimalist terminal coding harness with multi-provider LLM support
+and an extension system. Our adapter layers the portable `.agent/` brain
+on top so you keep one knowledge base even if you later swap harnesses.
+
+## Install
+```bash
+./install.sh pi
+```
+
+Then install pi itself:
+```bash
+npm install -g @mariozechner/pi-coding-agent
+```
+
+## What it wires up
+- `AGENTS.md` — pi reads this natively as workspace-level context.
+  Points at `.agent/`. **Skipped if `AGENTS.md` already exists**
+  (e.g. from the hermes or opencode adapter — pi reads the same file,
+  so you don't need a second copy).
+- `.pi/skills/` → symlink to `.agent/skills/`. Pi scans this path at
+  startup. Symlink means there's one source of truth; customize under
+  `.agent/skills/` and pi sees it immediately.
+- `.pi/` directory is created even if empty — ready for optional pi
+  extensions, prompt templates, and `.pi/SYSTEM.md` overrides.
+
+## Coexisting with other adapters
+Pi, hermes, and opencode all read `AGENTS.md`. You can install any
+combination — only the first one to run writes the root `AGENTS.md`;
+subsequent installs are no-ops on that file.
+
+## Verify
+In pi: ask "what's in my LESSONS file?" — it should read
+`.agent/memory/semantic/LESSONS.md`.
+
+## Optional
+If pi's default system prompt doesn't fit your workflow, drop a
+`.pi/SYSTEM.md` at project root. Pi uses it as a complete override.

docs/per-harness/pi.md

@@ -0,0 +1,38 @@
+# Pi Coding Agent setup
+
+[Pi Coding Agent](https://github.com/badlogic/pi-mono) (by Mario
+Zechner) is a minimalist terminal coding harness with 15+ LLM providers
+and a TypeScript extension system. Our adapter layers the portable
+`.agent/` brain on top so you keep one knowledge base across harnesses.
+
+## What the adapter installs
+- `AGENTS.md` at project root (pi reads this natively). Skipped if one
+  already exists, since pi/hermes/opencode share this file.
+- `.pi/` directory
+- `.pi/skills` symlinked to `.agent/skills` (falls back to copy on
+  platforms without symlinks, e.g. Windows without developer mode)
+
+## Install
+```bash
+./install.sh pi
+npm install -g @mariozechner/pi-coding-agent
+pi
+```
+
+## How it works
+- Pi loads `AGENTS.md` (or `CLAUDE.md`) from `~/.pi/agent/` and walks
+  the current directory up to the filesystem root, aggregating
+  context.
+- Skills at `.pi/skills/<name>/SKILL.md` use the same frontmatter-plus
+  -body shape as agentskills.io and our `.agent/skills/` layout.
+- Pi extensions live in `.pi/extensions/` (TypeScript, optional).
+
+## Troubleshooting
+- If pi doesn't see your skills, run `pi skills list` — it should
+  print entries from `.pi/skills/`. If the directory is a broken
+  symlink, re-run `./install.sh pi` to rebuild.
+- On Windows without symlink support, the installer copies
+  `.agent/skills/` instead. Changes to `.agent/skills/` won't
+  propagate — re-run the installer to sync.
+- Pi's multi-provider gateway is independent of the brain. The
+  portable `.agent/` doesn't care which model you use.

install.sh

@@ -1,7 +1,7 @@
 #!/usr/bin/env bash
 # install.sh — copy an adapter into the consuming project, then run the onboarding wizard
 # Usage: ./install.sh <adapter-name> [target-dir] [--yes] [--reconfigure]
-#   adapter-name:  claude-code | cursor | windsurf | opencode | openclient | hermes | standalone-python
+#   adapter-name:  claude-code | cursor | windsurf | opencode | openclient | hermes | pi | standalone-python
 #   target-dir:    where your project lives (default: current dir)
 #   --yes          accept all wizard defaults without prompting (safe for CI)
 #   --reconfigure  re-run the wizard even if PREFERENCES.md is already filled
@@ -13,7 +13,7 @@ HERE="$(cd "$(dirname "$0")" && pwd)"
 
 if [[ -z "$ADAPTER" ]]; then
   echo "usage: $0 <adapter-name> [target-dir]" >&2
-  echo "adapters: claude-code cursor windsurf opencode openclient hermes standalone-python" >&2
+  echo "adapters: claude-code cursor windsurf opencode openclient hermes pi standalone-python" >&2
   exit 2
 fi
 
@@ -64,6 +64,27 @@ case "$ADAPTER" in
   hermes)
     cp "$SRC/AGENTS.md" "$TARGET/AGENTS.md"
     ;;
+  pi)
+    # pi, hermes, and opencode all read AGENTS.md — don't stomp an existing one
+    if [[ -f "$TARGET/AGENTS.md" ]]; then
+      echo "  ~ $TARGET/AGENTS.md already exists — skipping (pi reads whatever is there)"
+    else
+      cp "$SRC/AGENTS.md" "$TARGET/AGENTS.md"
+      echo "  + AGENTS.md"
+    fi
+    mkdir -p "$TARGET/.pi"
+    # symlink .pi/skills -> .agent/skills so pi sees the one true skill tree.
+    # ln -sfn atomically replaces an existing symlink; fall back to cp -R
+    # on filesystems that don't support symlinks (e.g. Windows without dev mode).
+    SKILLS_SRC="$(cd "$TARGET/.agent/skills" && pwd)"
+    if ln -sfn "$SKILLS_SRC" "$TARGET/.pi/skills" 2>/dev/null; then
+      echo "  + .pi/skills -> $SKILLS_SRC"
+    else
+      rm -rf "$TARGET/.pi/skills"
+      cp -R "$SKILLS_SRC" "$TARGET/.pi/skills"
+      echo "  + .pi/skills (copy; symlink not supported here)"
+    fi
+    ;;
   standalone-python)
     cp "$SRC/run.py" "$TARGET/run.py"
     ;;