Merge pull request #604 from HenryLach/docs/pi-repo-sweep-and-install-tutorial-path

docs: install tutorial PATH co-location + Pi GitHub URL sweep

Author: HenryLach

CONTRIBUTING.md

@@ -25,7 +25,7 @@ This project follows the [Contributor Covenant Code of Conduct](CODE_OF_CONDUCT.
 
 - [Node.js](https://nodejs.org/) ≥ 20.0.0
 - [Git](https://git-scm.com/)
-- [pi](https://github.com/badlogic/pi-mono) (the AI coding agent Taskplane extends)
+- [pi](https://github.com/earendil-works/pi) (the AI coding agent Taskplane extends)
 - [just](https://github.com/casey/just) (optional — task runner for common commands)
 
 ### Clone and Install

README.md

@@ -1,6 +1,6 @@
 # Taskplane
 
-Multi-agent AI orchestration for coding with [pi](https://github.com/badlogic/pi-mono) — parallel task execution, mono- and poly-repo support, fresh-context worker loops, cross-model reviews, automated merges and a killer dashboard! 
+Multi-agent AI orchestration for coding with [pi](https://github.com/earendil-works/pi) — parallel task execution, mono- and poly-repo support, fresh-context worker loops, cross-model reviews, automated merges and a killer dashboard! 
 
 > **Status:** Initial release.
 
@@ -50,7 +50,7 @@ Taskplane is a pi package. You need Node.js 22+, pi and Git installed first.
 | Dependency | Required | Notes |
 |-----------|----------|-------|
 | [Node.js](https://nodejs.org/) ≥ 22 | Yes | Runtime |
-| [pi](https://github.com/badlogic/pi-mono) | Yes | Agent framework |
+| [pi](https://github.com/earendil-works/pi) | Yes | Agent framework |
 | [Git](https://git-scm.com/) | Yes | Version control, worktrees |
 
 IMPORTANT: If you just installed pi, make sure you've configured at least one model provider and tested before installing Taskplane.

docs/specifications/cli/CLI-SPEC.md

@@ -9,7 +9,7 @@
 
 ## 1. Problem Statement
 
-Taskplane is an AI agent orchestration system built as a set of [pi](https://github.com/badlogic/pi-mono) extensions. It provides:
+Taskplane is an AI agent orchestration system built as a set of [pi](https://github.com/earendil-works/pi) extensions. It provides:
 
 - **Task Runner** (`/task`) — Autonomous single-task execution with checkpoint discipline, fresh-context worker loops, and cross-model reviews
 - **Task Orchestrator** (`/orch`) — Parallel multi-task execution using git worktrees, dependency-aware wave scheduling, and automated merges

docs/tutorials/install.md

@@ -5,7 +5,7 @@ This tutorial gets Taskplane running in a project and verifies that `/orch` is a
 ## Prerequisites
 
 - Node.js **22+**
-- [pi](https://github.com/badlogic/pi-mono)
+- [pi](https://github.com/earendil-works/pi)
 - Git
 
 ---
@@ -22,7 +22,25 @@ Use this if you want Taskplane commands available in every pi session.
 pi install npm:taskplane
 ```
 
-> **Recommended.** This registers the package for pi extension/skill auto-discovery AND keeps Taskplane updateable via `pi update` (a single source of truth).
+As of pi `0.75.0`, this installs Taskplane into pi's private extension directory (`~/.pi/agent/npm/node_modules/`) rather than the system npm-global root. To make the `taskplane` CLI callable from your shell, add pi's bin dir to PATH once:
+
+```bash
+# bash / zsh — add to ~/.bashrc or ~/.zshrc
+export PATH="$HOME/.pi/agent/npm/node_modules/.bin:$PATH"
+```
+
+```powershell
+# PowerShell — persistent across sessions (set the user-scope env var once)
+[Environment]::SetEnvironmentVariable(
+  "PATH",
+  "$HOME\.pi\agent\npm\node_modules\.bin;" + [Environment]::GetEnvironmentVariable("PATH", "User"),
+  "User"
+)
+```
+
+With Pi's bin dir on PATH, `pi update` keeps Taskplane current automatically — a single source of truth, no second update command needed.
+
+> **Recommended.** This pattern registers the package for pi extension/skill auto-discovery AND keeps Taskplane updateable via `pi update`.
 
 > **Avoid `npm install -g taskplane`** unless you have a specific reason. As of pi `0.75.0`, `pi install` puts Taskplane in pi's private extension directory (`~/.pi/agent/npm/node_modules/`). A separate `npm install -g taskplane` creates a **second** on-disk copy in the system npm-global root, and the two drift independently — `pi update` only refreshes the pi-private copy. If you're already in this state, `taskplane doctor` detects it and prints a remediation.