docs(pi): update installation and remote login guidance

[StiensWout]

Pi setup guidance omitted the current Node requirement, installer choices and remote login recovery.

Document Node 22.19+, supported Pi versions, platform and npm installation, remote authentication and updates. Match the server installation hint to the npm command.

Validation: Compared commands and requirements with official Pi 1.1.0 documentation. Scoped status lint and documentation formatting/diff checks passed.

_{Prepared for Wout by gpt-6.1-sol in Codex.}

[macroscopeapp]

Approvability

Verdict: Not approved

Macroscope's review found this PR not approvable — The changes are mostly documentation and do not modify Pi runtime behavior, product defaults, schemas, or static-analysis configuration. Human review is still appropriate because the new guidance changes how users authenticate remotely and handle authorization redirects and API keys.

^{You can add or adjust custom eligibility rules. Learn more.}

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

• Configuration used: Path: .coderabbit.config.ts
• Review profile: CHILL
• Plan: Advanced
• Run ID: 5be1733d-5a84-4c28-a2fb-ced071013dd9

---

📥 Commits

Reviewing files that changed from the base of the PR and between 8c777fb and 80f381c.

---

📒 Files selected for processing (3)

• docs/user/install.md
• docs/user/providers-pi.md
• packages/provider-pi/src/server/status.ts

---

Included review availability: This review used your included allowance. Your plan provides up to 10 included reviews per hour; 7 remain after this review.

---

---

📝 Walkthrough

Walkthrough

Pi setup documentation now covers supported versions, installation, authentication, remote authorization, and updates. The missing-installation message includes --ignore-scripts in its npm install command.

Changes

Pi setup

Layer / File(s)	Summary
Installation and setup guidance docs/user/install.md, docs/user/providers-pi.md, packages/provider-pi/src/server/status.ts	The documentation updates Pi version requirements and setup instructions, and adds installation, remote authentication, API-key, and update guidance. The missing-installation message now includes --ignore-scripts in its npm command.

Priority: ⬇️ Low

Estimated code review effort: 2 (Simple) | ~10 minutes

Change: Other

Suggested reviewers: juliusmarminge

---

Merge Risk: ⚪ Minimal · up to 80f38

The setup guidance matches the provider and Pi installation, authentication, and update paths. No actionable merge-blocking risk remains.

Architecture Summary

Architecture risk: 🔵 Low · up to 80f38

The change affects 2 systems.

Changed systems: packages/provider-pi, docs

Architecture concerns
No architecture-level concerns identified.

Review details

Systems and components

• observed — packages/provider-pi (library) was modified; 1 changed file maps to changed impact.
• observed — docs (service) was modified; 2 changed files map to changed impact.

Before / after behavior

• observed — Modified behavior in docs/user/install.md: The Pi setup instructions now link to T3 Code’s provider guide, require Node.js 22.19 or newer, and direct users to run pi and /login; they replace the pi.dev link and the prior login-or-API-key setup wording.
• observed — Modified behavior in docs/user/providers-pi.md: The setup steps now link to Pi, specify the supported Node.js and Pi versions, direct users to authenticate with /login, and retain the Settings steps to enable and refresh the provider.
• observed — Modified behavior in docs/user/providers-pi.md: Adds an npm global-install command using --ignore-scripts.
• observed — Modified behavior in docs/user/providers-pi.md: Adds instructions for authenticating to Pi on a remote or headless server, including opening the authorization URL locally, entering a final redirect URL or authorization code when the callback cannot reach the server, and configuring sensitive API-key environment variables in Pi.

---

Pre-merge checks | 4

✅ Passed checks (4 passed)

Check name	Status	Explanation
Title check		The title clearly summarizes the main changes to Pi installation and remote login guidance.
Description check		The description covers the problem, planned changes, verification performed, and agent attribution. It does not use the required section headings or provide scope and approval details, but the core in…
Linked Issues check		Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check		Check skipped because no linked issues were found for this pull request.

---

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create a new PR

---

• Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

---

_{Comment @coderabbitai help to get the list of available commands.}