Get set upHarnesses

Harnesses on your own login

EasyCode drives each harness unmodified on your own login and never reads its credentials. Install one, sign in, and pick how it runs.

Last updated November 15, 2026View as Markdown

A harness is a coding agent you run from a terminal, such as Claude Code or Codex. EasyCode drives seven of them. Each one runs unmodified on your machine, signed in with your own account.

What "on your own login" means

  • You sign in, not EasyCode. When you click Connect, EasyCode runs the harness's own sign-in command in a terminal inside the app. The harness writes and keeps its own token.
  • EasyCode never reads credentials. It asks the harness's own status command whether you are signed in. For Gemini, Copilot and pi there is no such command, so their state stays Unknown after you sign in.
  • Your plan pays for your work. Usage counts against your own subscription or API key, under your vendor's terms.

Which harness should I use?

Claude Code, Codex, Cursor and OpenCode have Full support. Gemini, Copilot and pi are in Preview: they run over the Agent Client Protocol (ACP) and no release of them is tested yet. The harness matrix lists each one's install command, sign-in command and tested versions.

If your team has no preference, start with Claude Code or Codex. They have the most features, and knowledge tasks run on one of the two (knowledge.harness).

Install and sign in

Open Settings → Harnesses in the desktop app. The page lists the harnesses on this machine under Connected, Needs attention and Available to install.

For a harness that isn't installed, click Install. It runs the vendor's official install command in a terminal.

Click Connect and finish the sign-in in your browser or in the terminal. Claude Code and Codex offer more methods under Sign-in options.

You can also sign in from your own terminal. The command per harness:

claude auth login

Pick a default

There is no single default harness. When you start a session, EasyCode preselects the first harness that is installed and signed in, and you change it in the Harness menu. Two things you do set once:

  • The default account. A harness can hold several accounts, for example Work and Personal, each in its own config folder. Click Make default on the account a new session should use. Each space can set its own default accounts under Settings → Spaces.
  • The driver. Under a harness's advanced options, Automatic picks the best driver available: Native (full features through the vendor's SDK), ACP, or Headless (one process per turn, fewest features). Leave it on Automatic unless support asks you to change it (harnesses.<id>.driver).

A version that's too new or too old

If your installed version is newer than the tested range, EasyCode still runs it and says some features may be missing. If it is older than the supported range or a known-broken release, the card says Needs update and offers Update.

The harnesses

Something wrong or missing? Suggest a change

On this page