authorgravatar for 71498452+StiensWout@users.noreply.github.comWout Stiens <71498452+StiensWout@users.noreply.github.com> 2026-10-11 00:46:19+02:00
committergravatar for noreply@github.comGitHub <noreply@github.com> 2026-10-10 17:46:19-05:00
loge408cac0d7d903ccfcecfb906d4e48292294ab55
tree524dc9f2f1ae6a7743947b2d6e66d5044e84151d
parentc8b89a01d70fd54cbc6b6a70ba0fdff702b821aa
signature Signed by PGP key B5690EEEBB952194

docs(pi): update installation and remote login guidance (#17836)

3 files changed, 22 insertions(+), 5 deletions(-)

docs/user/install.md+1-1
......@@ -142,7 +142,7 @@ computer.
142142| Grok Build | Install [Grok Build CLI](https://x.ai/cli), then run `grok login`. |
143143| OpenCode | Install [OpenCode](https://opencode.ai), then run `opencode auth login`. |
144144| Antigravity | Install and sign in with Google from T3 Code's provider settings. |
145| Pi | Install [Pi](https://pi.dev), then run `pi` once to finish its login or API-key setup. |
145| Pi | Install [Pi](./providers-pi.md#set-up-pi) with Node.js 22.19 or newer, then run `pi` and `/login`. |
146146| Muse Code | Install [Muse Code](https://dev.meta.ai/docs/muse-code) on the server, run `muse login`, then enable it in Settings → Providers. |
147147
148148Provider CLIs must be on the server's `PATH`. If T3 Code cannot find one, set its
docs/user/providers-pi.md+20-3
......@@ -5,17 +5,34 @@ extensions, skills, context files, and native session history.
55
66## Set Up Pi
77
81. Install Pi on the machine running the T3 Code server. Pi 1.0 is recommended; 0.80.5 is the
9 oldest version T3 Code supports.
102. Run Pi once in a terminal and finish the provider login or API-key setup you normally use.
81. Install [Pi](https://pi.dev) on the machine running the T3 Code server. Pi requires Node.js
9 22.19 or newer; its platform installers can install Node if needed. T3 Code supports Pi
10 0.80.5 or newer.
112. Run `pi` in a terminal, then `/login` to connect your model provider or configure its API key.
11123. Open T3 Code Settings, enable Pi, and refresh the provider.
1213
14For an npm installation, use:
15
16```sh
17npm install -g --ignore-scripts @earendil-works/pi-coding-agent
18```
19
1320If `pi` is not on the server's `PATH`, set Pi's binary path to the executable. Provider environment
1421variables and launch arguments are also available for installations that need a custom agent
1522directory, endpoint, or model configuration. `--provider` must be paired with `--model`. T3 Code
1623rejects launch arguments that change Pi's execution mode or select a session because T3 owns those
1724parts of the process lifecycle.
1825
26On a remote or headless server, connect to that machine over SSH and run `pi`, then `/login`.
27Open the authorization URL on your own computer. If the callback cannot reach the server,
28paste the final redirect URL or authorization code back into Pi when prompted. You can also
29set your model provider's API-key environment variable in the Pi instance's settings; mark
30secret values as sensitive.
31
32Update installer-managed Pi with `pi update`. If another package manager owns the installation,
33update it through that manager instead. For example, a Nix profile installation uses
34`nix profile upgrade pi`.
35
1936## What Carries Over
2037
2138T3 Code discovers the models reported by Pi and exposes their supported thinking levels. The
packages/provider-pi/src/server/status.ts+1-1
......@@ -303,7 +303,7 @@ export const checkPiProviderStatus = Effect.fn("checkPiProviderStatus")(function
303303 status: "error",
304304 auth: { status: "unknown" },
305305 message: isCommandMissingCause(error)
306 ? "Pi CLI (`pi`) is not installed or not on PATH. Install with `npm install -g @earendil-works/pi-coding-agent`."
306 ? "Pi CLI (`pi`) is not installed or not on PATH. Install with `npm install -g --ignore-scripts @earendil-works/pi-coding-agent`."
307307 : "Failed to execute Pi CLI health check.",
308308 },
309309 });