Get set upHarnesses

The pi harness

Install pi, sign in on your own login, and the versions EasyCode is tested with.

Generated from the codeView as Markdown

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-acp

Update 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

DriverTested up toChosen automatically
acpNot yet testedNo

What's specific to pi

  • Two packages. ACP sessions need both pi and the pi-acp adapter. The install command above installs both; EasyCode checks that both are on your machine.
  • Signing in. Run pi, then type /login inside it and pick a provider. To sign out, type /logout and 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

On this page