The pi harness
Install pi, sign in on your own login, and the versions EasyCode is tested with.
pi is an open-source coding agent for the terminal that works with many model providers. EasyCode runs it on your machine, signed in with your own provider accounts, and never reads its credentials.
What EasyCode uses it for
pi runs chat sessions over the Agent Client Protocol (ACP), through the pi-acp adapter. Support is in Preview:
no release is tested yet, so Automatic doesn't choose ACP for it. To chat with it, set its driver to ACP
under the harness's advanced options in Settings → Harnesses, or run it in a terminal session.
The install and tested versions below come from the runner's harness catalog.
pi is made by pi-mono. Support is in preview: no release is tested yet. Its own documentation.
Install
npm install -g --ignore-scripts @earendil-works/pi-coding-agent pi-acpUpdate it with npm install -g --ignore-scripts @earendil-works/pi-coding-agent@latest pi-acp@latest.
Sign in
EasyCode has no sign-in command on record for pi: sign in on your own login as its documentation describes.
Tested versions
| Driver | Tested up to | Chosen automatically |
|---|---|---|
acp | Not yet tested | No |
What's specific to pi
- Two packages. ACP sessions need both
piand thepi-acpadapter. The install command above installs both; EasyCode checks that both are on your machine. - Signing in. Run
pi, then type/logininside it and pick a provider. To sign out, type/logoutand pick the provider. - No Claude subscription login. EasyCode won't run pi on Anthropic through a Claude subscription login; it
stops with "EasyCode won't drive that — switch pi to an API key or another provider". Use an Anthropic API key
or another provider, and pick a model that names its provider, for example
anthropic/…. - Sign-in state stays Unknown. EasyCode never opens pi's auth files, so the card always shows Unknown for pi, and can't show your email or plan.
- Several accounts. Each account is its own pi agent folder; add one with Add account.
See Harnesses on your own login for how the drivers and default accounts work.
Something wrong or missing? Suggest a change