Local-first Codex operations

EasyCodex

Run Codex on your desktop. Control it from anywhere nearby.

EasyCodex turns your computer into a secure relay for Codex agents and gives your Android phone a production-grade control surface for live tasks, approvals, diffs, attachments, CLI windows, and notifications.

Download latest releaseSee how it worksView on GitHub

Android controllerElectron relay appNode Agent RelayCodex app-server

Built for developers who keep code localWindowsmacOSLinuxAndroidCodex CLI

A Real Control Plane, Not a Chat Shell

Product surface

Everything that usually pulls you back to the laptop is available on mobile.

EasyCodex keeps the agent process on your workstation while exposing the decisions, files, and runtime state you actually need to manage work. The phone can follow a long-running session, queue a follow-up while Codex is busy, answer approvals, inspect Git output, and receive completion notifications.

Session controlCreate, resume, interrupt, stop, archive, and reopen Codex threads.

Review loopRead plans, commands, file changes, Git status, full diffs, and selected file previews.

Input channelSend text, images, and files; attachments stay under the selected workspace.

Mobile CLIOpen separate `codex exec` windows with cwd, model, reasoning, and sandbox controls.

How EasyCodex Works

1. Pair the client

The desktop relay displays a QR code and `easycodex://connect` deep link. The Android app stores the relay URL and API key locally, then connects over an authenticated WebSocket.

2. Choose a trusted workspace

The relay only allows file, Git, CLI, and agent cwd operations inside known workspace roots or explicitly trusted directories.

3. Start or resume Codex

For agent sessions, the relay launches `codex app-server`, initializes a thread, and converts Codex JSON-RPC events into stable mobile and desktop messages.

4. Keep the work moving

Approvals, user-input prompts, plan reviews, command output, file changes, and queued follow-ups are streamed back to the phone and desktop workbench.

Why Teams Would Use It

Remote supervisionStep away without losing control.

Keep Codex running on the workstation and approve or redirect the task from your phone when it reaches a decision point.

Local security postureNo hosted project mirror.

The phone does not receive a copy of the repository. It talks to your own relay, which enforces workspace boundaries.

Agent-heavy workflowMonitor more than chat text.

EasyCodex surfaces plans, sub-agent activity, command output, diffs, Git status, CLI windows, and unread completions.

Security Model

API-key protected relay

WebSocket clients and health checks require the relay API key.

Workspace-bound operations

File, Git, CLI, and agent runtime actions are validated against allowed roots.

Local runtime state

Relay state lives under `~/.easycodex/`; Codex state remains under `~/.codex/`.

Ready to try it

Download the relay and pair your Android controller.

Install the desktop relay, scan the QR code, choose a workspace, and start controlling Codex sessions from your phone.

Get EasyCodexRead quick start