# 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](https://github.com/earendil-works/pi).

## Install

```sh
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](https://github.com/earendil-works/pi) 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 `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](/setup/harnesses) for how the drivers and default accounts work.
