From 4d3929578f2d9f828e74cbd7f9c4f756b1ee5d13 Mon Sep 17 00:00:00 2001 From: Kevin Kern Date: Tue, 28 Jul 2026 09:57:07 +0200 Subject: [PATCH] docs: surface Pi and 1.9.0 on public entry points --- README.md | 33 ++++++++++++++++++++++++++++++--- apps/docs/app/page.tsx | 10 +++++----- 2 files changed, 35 insertions(+), 8 deletions(-) diff --git a/README.md b/README.md index 7c4f279f..63271d59 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ ![Planr — turn chaotic agent work into a verified task graph](public/planr_banner1.webp) -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() {

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() {
- +
@@ -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={} />