# OpenCode harness

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

OpenCode 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

OpenCode runs chat and terminal sessions. EasyCode drives it over the Agent Client Protocol
(ACP), or **Headless**, one process per turn. **Automatic** picks between them for you. Knowledge tasks don't run on
OpenCode; they run on Claude Code or Codex.

The install, sign-in and tested versions below come from the runner's harness catalog.

OpenCode is made by Anomaly. EasyCode supports it fully. [Its own documentation](https://opencode.ai/docs).

## Install

```sh
curl -fsSL https://opencode.ai/install | bash
```

Update it with `opencode upgrade`.

## Sign in

Sign in on your own login with `opencode auth login`.

## Tested versions

| Driver | Tested up to | Chosen automatically |
| --- | --- | --- |
| `headless` | 1.19.3 | Yes |
| `acp` | 1.19.3 | Yes |

## What's specific to OpenCode

- **Providers, not one account.** `opencode auth login` signs you in to a model provider. You can sign in to
  several; the card lists the providers `opencode auth list` reports.
- **It asks before it acts.** OpenCode's own default lets every edit and command run. In an EasyCode session it
  asks first, so each edit and shell command comes to you as a permission request.
- **No merges or pushes to main.** EasyCode adds rules that deny merging a pull request and pushing to `main` or
  `master`. They apply on top of your own OpenCode config, which EasyCode keeps.

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