Codex harness
Install Codex, sign in on your own login, and the versions EasyCode is tested with.
Codex is OpenAI's coding agent for the terminal. EasyCode runs it on your machine, signed in with your own ChatGPT account, and never reads its credentials.
What EasyCode uses it for
Codex runs chat and terminal sessions. On the Native
driver EasyCode talks to Codex's own app server, which gives the most features. Codex and Claude Code are the two
harnesses that can run knowledge tasks (knowledge.harness).
The install, sign-in and tested versions below come from the runner's harness catalog.
Codex CLI is made by OpenAI. EasyCode supports it fully. Its own documentation.
Install
npm install -g @openai/codexUpdate it with npm install -g @openai/codex@latest.
Sign in
Sign in on your own login with codex login (methods: device).
Tested versions
| Driver | Tested up to | Chosen automatically |
|---|---|---|
codex-app-server | 0.163.0 | Yes |
headless | 0.163.0 | Yes |
acp | 0.163.0 | No |
What's specific to Codex
- Sign-in options. Connect signs in with your ChatGPT account in the browser. On a machine without a browser, pick Device code under Sign-in options.
- Several accounts. Each account is its own Codex home folder. Add one with Add account, and click Make default on the one new sessions should use.
- Limit resets. When your plan gives you limit resets, the card lists them under Limit resets. Use reset spends one, after you confirm.
- MCP servers. You can connect the Linear or Atlassian MCP server to Codex in one click, under
Settings → Harnesses. It runs Codex's own
codex mcp addand sign-in commands. - ACP. The ACP driver needs an optional adapter. Automatic prefers the native driver, so you rarely need it.
See Harnesses on your own login for how the drivers and default accounts work.
Something wrong or missing? Suggest a change