feat: add Pi CLI package

Author: nhorton

.codex/config.toml

@@ -0,0 +1,2 @@
+[features]
+codex_hooks = true

.codex/hooks.json

@@ -0,0 +1,48 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "startup|resume",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "uvx deepwork codex-hook session_start",
+            "statusMessage": "Loading DeepWork context"
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "uvx deepwork codex-hook post_tool_use",
+            "statusMessage": "Checking DeepWork post-tool hooks"
+          }
+        ]
+      },
+      {
+        "matcher": "Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "uvx deepwork codex-hook post_write",
+            "statusMessage": "Validating DeepSchema after write"
+          }
+        ]
+      },
+      {
+        "matcher": "Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "uvx deepwork codex-hook post_edit",
+            "statusMessage": "Validating DeepSchema after edit"
+          }
+        ]
+      }
+    ]
+  }
+}

.gitignore

@@ -85,6 +85,7 @@ result
 
 # Distribution / packaging
 *.whl
+node_modules/
 
 # Logs
 *.log

README.md

@@ -11,6 +11,19 @@ DeepWork fixes this with two systems: **Workflows** that force agents to follow
 claude plugin marketplace add Unsupervisedcom/deepwork && claude plugin install deepwork@deepwork-plugins && claude "/deepwork:new_user"
 ```
 
+### Pi CLI
+```
+pi install git:github.com/Unsupervisedcom/deepwork
+```
+
+Then start Pi in a project and run `/deepwork_setup`, followed by `/new_user`.
+The Pi package covers the main DeepWork workflows, reviews, DeepSchemas, and
+planning skills. It does not install the separate learning-agents plugin.
+
+For parallel `/review` execution in Pi, optionally install
+`@tintinweb/pi-subagents`. DeepWork detects it lazily on the first review run and
+falls back to sequential reviews when it is absent.
+
 The onboarding flow will introduce you to DeepWork and help you get started. Or, do the task you want to automate — just ask Claude to do it, and work with Claude to refine it as you go:
 ```
 Research our top 3 competitors and write a SWOT analysis for each one.
@@ -138,7 +151,14 @@ In Claude Code:
 claude plugin marketplace add Unsupervisedcom/deepwork && claude plugin install deepwork@deepwork-plugins && claude "/deepwork:new_user"
 ```
 
-The onboarding flow walks you through setup. If you prefer to skip it, just start a new Claude Code session.
+In Pi CLI:
+```
+pi install git:github.com/Unsupervisedcom/deepwork
+```
+
+Then run `/deepwork_setup` in your project and invoke `/new_user`.
+
+The onboarding flow walks you through setup. If you prefer to skip it, start a new session in your agent CLI.
 
 > **Note:** If your folder isn't a Git repo yet, run `git init` first.
 
@@ -375,10 +395,11 @@ Use `/deepschema` for the full reference on creating and managing schemas.
 | Platform | Status | Notes |
 |----------|--------|-------|
 | **Claude Code** | Full Support | Recommended. Plugin-based delivery with quality hooks. |
+| **Pi CLI** | Full Support | Pi package with MCP adapter integration, skills, and extension hooks. |
 | **Gemini CLI** | Partial Support | TOML format skill, manual setup |
 | OpenCode | Planned | |
 | GitHub Copilot CLI | Planned | |
-| Others | Planned | We are nailing Claude and Gemini first, then adding others according to demand |
+| Others | Planned | We are adding platforms according to demand |
 
 **Tip:** Use the terminal (Claude Code CLI), not the VS Code extension. The terminal has full feature support.
 

doc/architecture.md

@@ -87,7 +87,7 @@ deepwork/                       # DeepWork tool repository
 │       │   ├── discovery.py    # Find .deepreview files in project tree
 │       │   ├── matcher.py      # Git diff + glob matching + strategy grouping
 │       │   ├── instructions.py # Generate review instruction files
-│       │   ├── formatter.py    # Format output for Claude Code
+│       │   ├── formatter.py    # Format review output for agent platforms
 │       │   ├── mcp.py          # MCP adapter for review pipeline
 │       │   └── schema.py       # JSON schema loader
 │       ├── schemas/            # Definition schemas
@@ -121,8 +121,13 @@ deepwork/                       # DeepWork tool repository
 │   │   │   └── review/SKILL.md
 │   │   ├── hooks/              # hooks.json, post_commit_reminder.sh, post_compact.sh, startup_context.sh, deepschema_write.sh
 │   │   └── .mcp.json           # MCP server config
-│   └── gemini/                 # Gemini CLI extension
-│       └── skills/deepwork/SKILL.md
+│   ├── gemini/                 # Gemini CLI extension
+│   │   └── skills/deepwork/SKILL.md
+│   └── pi/                     # Pi CLI package
+│       ├── package.json
+│       ├── extensions/index.ts
+│       ├── mcp.json.example
+│       └── skills/
 ├── library/jobs/               # Reusable example jobs
 ├── tests/                      # Test suite
 ├── doc/                        # Documentation
@@ -170,7 +175,7 @@ The review command:
 - Matches changed files against rules using include/exclude glob patterns
 - Groups files by review strategy (`individual`, `matches_together`, `all_changed_files`)
 - Generates per-task instruction files in `.deepwork/tmp/review_instructions/`
-- Outputs structured text for Claude Code to dispatch parallel review agents
+- Outputs platform-formatted review instructions for Claude Code and Pi
 
 ### 4. Jobs Command (`jobs.py`)
 
@@ -197,6 +202,7 @@ deepwork setup
 The setup command:
 - Detects Claude Code by checking for `~/.claude` directory
 - Configures `~/.claude/settings.json` with marketplace, plugin, MCP permissions, auto-update, and project-root-relative `Read`/`Write`/`Edit` permissions for `/.deepwork/**/*` (applies to every project)
+- Detects Pi CLI by checking for `~/.pi/agent` and adds the DeepWork Pi package source to `~/.pi/agent/settings.json`
 - Idempotent — safe to run multiple times
 - Preserves existing settings
 
@@ -206,8 +212,16 @@ Platform-specific delivery is now handled by plugins in `plugins/`:
 
 - **Claude Code**: `plugins/claude/` — installed as a Claude Code plugin via marketplace
 - **Gemini CLI**: `plugins/gemini/` — skill files copied to `.gemini/skills/`
+- **Pi CLI**: `plugins/pi/` — installed as a Pi package with skills, extension hooks, and MCP adapter integration
 
-Each plugin contains static files (skill, hooks, MCP config) rather than generated content. The shared skill body lives in `platform/skill-body.md` as the single source of truth.
+Each plugin contains checked-in skills and platform integration files rather than generated content. The shared core skill body lives in `platform/skill-body.md`.
+
+Pi reviews can optionally use `tintinweb/pi-subagents`. The Pi extension does
+not ping the subagent bus during startup; the first `/review` invocation sends a
+`subagents:rpc:ping` event and caches the result for the session. If the ping
+succeeds, each generated review task is spawned through `subagents:rpc:spawn`.
+If it fails or times out, the extension injects a sequential review prompt into
+the current session.
 
 ---
 
@@ -1162,4 +1176,3 @@ deepwork serve --transport sse --port 8000
 - [JSON Schema](https://json-schema.org/)
 - [Model Context Protocol](https://modelcontextprotocol.io/)
 - [FastMCP Documentation](https://github.com/jlowin/fastmcp)
-