diff --git a/README.md b/README.md
index 7c4f279f..63271d59 100644
--- a/README.md
+++ b/README.md
@@ -2,7 +2,7 @@

-Planr is a local-first planning and execution coordination tool for coding agents. It combines reviewable Markdown plans with a dependency-aware work map so Codex, Claude Code, Cursor, Grok Build, generic MCP clients, and human operators can drive the same work safely — from idea to verified completion.
+Planr is a local-first planning and execution coordination tool for coding agents. It combines reviewable Markdown plans with a dependency-aware work map so Codex, Claude Code, Cursor, Grok Build, Pi, generic MCP clients, and human operators can drive the same work safely — from idea to verified completion.
[**View the Demo →**](https://x.com/kevinkern/status/2066957434564808884?s=20)
@@ -53,7 +53,7 @@ curl -fsSL https://raw.githubusercontent.com/instructa/planr/main/scripts/instal
> On an affected Linux release, build from source on the target distribution or upgrade to v1.7.3.
-Then initialize a project. When selected, Claude Code and Cursor also receive standalone project worker/reviewer roles; Codex workflow skills come from its plugin. Grok Build is a separate explicit opt-in and is not included by `all`:
+Then initialize a project. When selected, Claude Code and Cursor also receive standalone project worker/reviewer roles; Codex workflow skills come from its plugin. Grok Build and Pi are separate explicit opt-ins and are not included by `all`:
```bash
planr project init "My Product" --client all
@@ -61,6 +61,16 @@ planr project init "My Product" --client all
Manual downloads, from-source builds, and client wiring details: [Install Guide](https://planr.so/docs/getting-started/installation).
+To add Pi's native Agent Skills and optional pi-subagents roles to a trusted repository, select it explicitly:
+
+```bash
+planr install pi --dry-run
+planr install pi
+planr project init "My Product" --client pi
+```
+
+Planr writes repository-local `.pi/skills/` workflow assets and optional `.pi/agents/` roles only. It does not install Pi, pi-subagents, MCP config, hooks, global settings, provider credentials, or session state. Full setup and trust guidance: [Pi integration](https://planr.so/docs/integrations/pi).
+
## Install The Plugin (Skills)
The plugin under `plugins/planr` carries the ten Planr workflow skills. Optional model-routing declarations live in repository-local files such as `.planr/agents.toml` and `.planr/policy.toml`; external tools may manage those files, but Planr does not install or invoke a routing engine. The `planr` CLI (above) is required separately.
@@ -123,6 +133,22 @@ Planr writes portable `.grok/config.toml` MCP configuration plus native `.grok/a
+
+
+Pi
+
+Preview or install the repository-local Pi integration:
+
+```bash
+planr install pi --dry-run
+planr install pi
+planr doctor --client pi --json
+```
+
+Planr writes native `.pi/skills/` workflow assets and optional `.pi/agents/` role files for `pi-subagents`. It writes no MCP configuration, hooks, extension package, global Pi settings, provider credentials, model pin, or session reference. Pi is intentionally explicit opt-in and is not part of `--client all`. See the [Pi integration guide](https://planr.so/docs/integrations/pi).
+
+
+
opencode
@@ -200,6 +226,7 @@ The watcher is likewise a human-only observer. It defaults to the condensed diag
## What's new
+- **1.9.0 — First-class Pi integration:** Added an explicit repository opt-in that installs native Pi Agent Skills plus optional `pi-subagents` worker/reviewer roles without treating Pi as an MCP host. The integration writes no Pi global settings, hooks, provider credentials, model pin, or session reference, and `--client all` remains unchanged for existing Codex, Claude Code, Cursor, and Grok setup. See the [Pi integration guide](https://planr.so/docs/integrations/pi), [Pi contract](docs/contracts/PI_INTEGRATION_V1.md), and [1.9.0 changelog](CHANGELOG.md#190---2026-07-27).
- **1.8.0 — First-class Grok Build integration:** Added an explicit repository opt-in that installs portable project MCP configuration plus native Grok agents and all ten Planr workflow skills. The integration writes no plugin, hooks, model setting, xAI credentials, or provider runtime dependency; authenticated verification remains maintainer-local and never runs in CI. See the [Grok Build guide](https://planr.so/docs/integrations/grok-build) and [1.8.0 changelog](CHANGELOG.md#180---2026-07-27).
- **1.7.2 — Reproducible release candidates:** Locked the pnpm workspace inventory, made external eval fixtures self-contained, refreshed reviewed workflow runtimes, and made all four published architectures execute the exact tagged version before upload. Model-backed evaluation remains a local, candidate-bound maintainer gate; this patch makes no unmeasured speed or quality claim. See the [1.7.2 changelog](CHANGELOG.md#172---2026-07-25) and [release guidance](https://planr.so/docs/operations/release).
- **1.7.1 — Leaner agent guidance and safer local releases:** Slimmed the hot-path Planr skills while preserving their execution and review contracts, moved maintainer benchmark inputs and results outside the public repository, added a fail-closed local release-evidence gate without API keys in CI, and verified the optional external Switchloom v0.3.2 integration. The public 1.7 eval CLI remains available in this patch. See the [1.7.1 changelog](CHANGELOG.md#171---2026-07-25) and [release guidance](https://planr.so/docs/operations/release).
@@ -220,7 +247,7 @@ Full documentation lives at [planr.so/docs](https://planr.so/docs).
- [Plugins and Model Routing](https://planr.so/docs/plugins) · [Recipes](https://planr.so/docs/guides/recipes)
- [Integrations and Host Hooks](https://planr.so/docs/integrations)
- [CLI Reference](https://planr.so/docs/reference/cli) · [MCP Reference](https://planr.so/docs/reference/mcp)
-- [Codex](https://planr.so/docs/integrations/codex) · [Claude Code](https://planr.so/docs/integrations/claude-code) · [Cursor](https://planr.so/docs/integrations/cursor) · [Grok Build](https://planr.so/docs/integrations/grok-build)
+- [Codex](https://planr.so/docs/integrations/codex) · [Claude Code](https://planr.so/docs/integrations/claude-code) · [Cursor](https://planr.so/docs/integrations/cursor) · [Grok Build](https://planr.so/docs/integrations/grok-build) · [Pi](https://planr.so/docs/integrations/pi)
- [Daily Worker Loop](https://planr.so/docs/guides/daily-worker-loop)
- [Task Graph Model](https://planr.so/docs/concepts/graph-and-readiness)
- [Architecture](https://planr.so/docs/contributing/architecture)
diff --git a/apps/docs/app/page.tsx b/apps/docs/app/page.tsx
index 2e011166..24bcd05f 100644
--- a/apps/docs/app/page.tsx
+++ b/apps/docs/app/page.tsx
@@ -25,7 +25,7 @@ export default function HomePage() {
- Local-first coordination for coding agents
+ Planr 1.9.0 with Pi runtime integration
Give every agent a plan.
@@ -33,7 +33,7 @@ export default function HomePage() {
Planr turns product intent into a durable task graph that Codex, Claude Code, Cursor,
- MCP clients, and humans can share without losing ownership or evidence.
+ Grok Build, Pi, MCP clients, and humans can share without losing ownership or evidence.
@@ -48,7 +48,7 @@ export default function HomePage() {
Local by default Graph-owned state
- Multi-client
+ 1.9.0 release
@@ -73,7 +73,7 @@ export default function HomePage() {
Works with your coding agent
Keep the tool you already trust.
- Planr gives every client the same durable plan, task graph, and evidence trail.
+ Planr gives Codex, Claude Code, Cursor, Grok Build, Pi, and MCP clients the same durable plan, task graph, and evidence trail.
{agentRecipeList.map((recipe) => (
@@ -112,7 +112,7 @@ export default function HomePage() {
href="/docs/integrations"
eyebrow="Connecting clients"
title="Use your preferred coding agent"
- description="Set up Codex, Claude Code, Cursor, a generic MCP host, or a CLI-only workflow."
+ description="Set up Codex, Claude Code, Cursor, Grok Build, Pi, a generic MCP host, or a CLI-only workflow."
icon={}
/>