Skip to content

Commit 80f381c

Browse files
committed
docs(pi): clarify installation and remote authentication
1 parent 8c777fb commit 80f381c

3 files changed

Lines changed: 22 additions & 5 deletions

File tree

‎docs/user/install.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -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

148148
Provider CLIs must be on the server's `PATH`. If T3 Code cannot find one, set its

‎docs/user/providers-pi.md‎

Lines changed: 20 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -5,17 +5,34 @@ extensions, skills, context files, and native session history.
55

66
## Set Up Pi
77

8-
1. 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.
10-
2. Run Pi once in a terminal and finish the provider login or API-key setup you normally use.
8+
1. 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.
11+
2. Run `pi` in a terminal, then `/login` to connect your model provider or configure its API key.
1112
3. Open T3 Code Settings, enable Pi, and refresh the provider.
1213

14+
For an npm installation, use:
15+
16+
```sh
17+
npm install -g --ignore-scripts @earendil-works/pi-coding-agent
18+
```
19+
1320
If `pi` is not on the server's `PATH`, set Pi's binary path to the executable. Provider environment
1421
variables and launch arguments are also available for installations that need a custom agent
1522
directory, endpoint, or model configuration. `--provider` must be paired with `--model`. T3 Code
1623
rejects launch arguments that change Pi's execution mode or select a session because T3 owns those
1724
parts of the process lifecycle.
1825

26+
On a remote or headless server, connect to that machine over SSH and run `pi`, then `/login`.
27+
Open the authorization URL on your own computer. If the callback cannot reach the server,
28+
paste the final redirect URL or authorization code back into Pi when prompted. You can also
29+
set your model provider's API-key environment variable in the Pi instance's settings; mark
30+
secret values as sensitive.
31+
32+
Update installer-managed Pi with `pi update`. If another package manager owns the installation,
33+
update it through that manager instead. For example, a Nix profile installation uses
34+
`nix profile upgrade pi`.
35+
1936
## What Carries Over
2037

2138
T3 Code discovers the models reported by Pi and exposes their supported thinking levels. The

‎packages/provider-pi/src/server/status.ts‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -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
});

0 commit comments

Comments
 (0)