# Copilot harness

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

Copilot CLI is GitHub's coding agent for the terminal. EasyCode runs it on your machine, signed in with your own
GitHub account and Copilot plan, and never reads its credentials.

## What EasyCode uses it for

Copilot runs chat sessions over the Agent Client Protocol (ACP). 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.

Copilot CLI is made by GitHub. Support is in preview: no release is tested yet. [Its own documentation](https://docs.github.com/en/copilot/how-tos/use-copilot-agents/use-copilot-cli).

## Install

```sh
npm install -g @github/copilot
```

Update it with `npm install -g @github/copilot@latest`.

## Sign in

EasyCode has no sign-in command on record for Copilot CLI: sign in on your own login as [its documentation](https://docs.github.com/en/copilot/how-tos/use-copilot-agents/use-copilot-cli) describes.

## Tested versions

| Driver | Tested up to | Chosen automatically |
| --- | --- | --- |
| `acp` | Not yet tested | No |

## What's specific to Copilot

- **Signing in.** Run `copilot login` in a terminal. For a machine without a browser, run `copilot login --device-code`.
  To sign out, run `copilot` and type `/logout`.
- **Sign-in state stays Unknown.** Copilot has no command that reports who is signed in, and EasyCode never opens
  its config file, so the card shows **Unknown** even after you sign in. The card also can't show your email or plan.
- **No merges from a session.** EasyCode starts Copilot with `gh pr merge` denied, so an agent can't merge a pull
  request on its own.
- **Several accounts.** Each account is its own Copilot home folder; add one with **Add account**.

See [Harnesses on your own login](/setup/harnesses) for how the drivers and default accounts work.
