Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
33 changes: 30 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)

Expand Down Expand Up @@ -53,14 +53,24 @@ 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.
<!-- planr:linux-release-portability:end surface=README schema=1 -->

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
```

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.
Expand Down Expand Up @@ -123,6 +133,22 @@ Planr writes portable `.grok/config.toml` MCP configuration plus native `.grok/a

</details>

<a id="install-pi"></a>
<details>
<summary><strong>Pi</strong></summary>

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).

</details>

<a id="install-plugin-opencode"></a>
<details>
<summary><strong>opencode</strong></summary>
Expand Down Expand Up @@ -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).
Expand All @@ -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)
Expand Down
10 changes: 5 additions & 5 deletions apps/docs/app/page.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -25,15 +25,15 @@ export default function HomePage() {
<div className="hero-copy">
<div className="hero-kicker">
<Sparkles aria-hidden="true" />
Local-first coordination for coding agents
Planr 1.9.0 with Pi runtime integration
</div>
<h1 id="home-title">
Give every agent a plan.
<span>Prove the work is done.</span>
</h1>
<p className="hero-lede">
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.
</p>
<div className="hero-actions">
<Link prefetch={false} className="button-primary" href="#agent-setup">
Expand All @@ -48,7 +48,7 @@ export default function HomePage() {
<div className="trust-row" aria-label="Product guarantees">
<span><ShieldCheck aria-hidden="true" /> Local by default</span>
<span><GitBranch aria-hidden="true" /> Graph-owned state</span>
<span><UsersRound aria-hidden="true" /> Multi-client</span>
<span><UsersRound aria-hidden="true" /> 1.9.0 release</span>
</div>
</div>
<div className="hero-terminal">
Expand All @@ -73,7 +73,7 @@ export default function HomePage() {
<div className="agent-heading">
<p>Works with your coding agent</p>
<h2 id="agent-title">Keep the tool you already trust.</h2>
<span>Planr gives every client the same durable plan, task graph, and evidence trail.</span>
<span>Planr gives Codex, Claude Code, Cursor, Grok Build, Pi, and MCP clients the same durable plan, task graph, and evidence trail.</span>
</div>
<div className="agent-grid">
{agentRecipeList.map((recipe) => (
Expand Down Expand Up @@ -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={<Braces />}
/>
</div>
Expand Down