A terminal for Codex CLI

coterm is a native macOS terminal built for AI coding agents, and the OpenAI Codex CLI runs in it out of the box. coterm is just a terminal, so codex works in any workspace, with coterm adding the multitasking, organization, and programmability around it.

Organize many Codex sessions

Run Codex in its own workspace per task. The vertical sidebar shows each one with its git branch, directory, ports, and latest output, so several parallel Codex runs stay organized instead of lost in tabs.

Notification rings when Codex needs you

When Codex finishes or asks for input, the pane rings and the sidebar flags it unread, so you can run several at once and return to the one that needs attention. Notifications fire automatically and can also be driven from agent hooks.

oh-my-codex

coterm ships an oh-my-codex integration that runs Codex in a coterm-aware environment so its activity surfaces as native coterm panes. See the oh-my-codex docs.

Check on Codex from your phone

coterm has an iOS companion app (beta): pair your iPhone with your Mac to check on your Codex runs, with optional notification forwarding, while you are away from the desk.

Scriptable

Everything is available through the coterm CLI and a Unix socket: create a workspace, launch Codex, send input, read the screen, take screenshots, and drive an in-app browser, all from a script.

FAQ

Does Codex CLI work in coterm?

Yes. coterm is a standard macOS terminal, so codex runs in any workspace with no extra setup.

Can I run Codex next to other agents?

Yes. Open a workspace per task and run Codex, Claude Code, or OpenCode side by side. The sidebar keeps every session legible.

How do I know when Codex needs input?

The pane rings and the sidebar shows an unread badge when Codex finishes or asks for input, so you can let it run and come back when it needs you.

Is coterm free to use with Codex?

Yes. coterm is free and open source for macOS.