Skip to content

Computer use for the Pi coding agent — Windows apps, browsers and desktops through native UI trees, screenshots and real input.

docs: keep worktree SDK setup within the dependency range

alexshpunt-clanker[bot]bf67c4e6ea06
diff --git a/.pi/skills/develop-computer-use/SKILL.md b/.pi/skills/develop-computer-use/SKILL.md
index 829f29d..af7c968 100644
--- a/.pi/skills/develop-computer-use/SKILL.md
+++ b/.pi/skills/develop-computer-use/SKILL.md
@@ -15,7 +15,7 @@ Do not use a project `.pi/settings.json` override with `extensions: []` plus a p
2. Back up `~/.pi/agent/settings.json` in the worktree's ignored `.tmp/` directory and record its SHA-256. Other agents may change the file while you work, so restore only your own line later, never the whole backup.
3. Replace only that package path with the absolute worktree path. Keep every other entry unchanged. Remove any leftover project loader (`.pi/extensions/computer-use.ts`) or project package override from older setups.
4. Put the runtime selection the check needs in the worktree's ignored `.pi/computer-use.json` (`command`, `runtime`, `interop`). The global checkout's own `.pi/computer-use.json` may name a profile the worktree code no longer has, so do not start Pi from the global checkout while the path is swapped.
-5. Check dependencies in this worktree. A fresh Git worktree has no `node_modules`; the global checkout does not provide them. Install with `npm ci --ignore-scripts --legacy-peer-deps`, link the public IDE SDK with `npm run dev:ide -- /absolute/path/to/pi-agent-ide`, then confirm `npm ls --depth=0` is clean. Do not change dependency versions, global installs or machine settings for this setup.
+5. Check dependencies in this worktree. A fresh Git worktree has no `node_modules`; the global checkout does not provide them. Install the locked public SDK with `npm ci --ignore-scripts --legacy-peer-deps`, then require a clean `npm ls --depth=0`. If the check needs SDK source, use `npm run dev:ide -- /absolute/path/to/pi-agent-ide` with a source version satisfying this package's dependency range and check the dependency tree again. A newer checkout outside the range is a setup failure, not a reason to change dependency versions or skip the check. Keep global installs and machine settings unchanged.
## Verify before reloading
diff --git a/docs/computer-resources.md b/docs/computer-resources.md
index 9e39ccb..b77ddd9 100644
--- a/docs/computer-resources.md
+++ b/docs/computer-resources.md
@@ -281,4 +281,4 @@ else if (r.outcome === "refused") { /* nothing was sent */ }
Close only task-owned windows. Delete a machine address to release that machine, and `computer:session` to release every machine, browser, sandbox and isolated session this computer use started; Pi's shutdown does the same. This does not close or save the user's documents. The result lists each released part; an uncertain cleanup is `unknown`.
-For a source checkout, run `npm ci --ignore-scripts --legacy-peer-deps`, then `npm run dev:ide -- /absolute/path/to/pi-agent-ide`. To try a worktree, point the package entry in your Pi settings at it, and point it back afterwards.
+For a source checkout, run `npm ci --ignore-scripts --legacy-peer-deps`. When SDK-source testing is needed, link a compatible IDE source version with `npm run dev:ide -- /absolute/path/to/pi-agent-ide`; keep it within this package's dependency range. To try a worktree, point the package entry in your Pi settings at it, and point it back afterwards.