easycodex

KO | EN

gitlite — search

#react #llm #golang #machine-learning #deep-learning #linux #macos #java #windows #awesome #cli #vue #mcp #open-source

(★ 29)

No description available.

easycodex Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1>EasyCodex</h1>
  <p><strong>A local-first mobile and desktop control room for Codex agents.</strong></p>
  <p>
    <a href="README.md">English</a> |
    <a href="README.zh-CN.md">简体中文</a> |
    <a href="README.zh-TW.md">繁體中文</a>
  </p>
  <p>
    <a href="https://github.com/Ryan-Laws/easycodex/releases/latest"><img alt="Latest release" src="https://img.shields.io/github/v/release/Ryan-Laws/easycodex?label=release&style=flat-square"></a>
    <a href="LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/license-MIT-green?style=flat-square"></a>
    <img alt="Windows" src="https://img.shields.io/badge/Windows-relay%20app-0078D4?logo=windows&logoColor=white&style=flat-square">
    <img alt="Android" src="https://img.shields.io/badge/Android-mobile%20APK-3DDC84?logo=android&logoColor=white&style=flat-square">
    <img alt="macOS" src="https://img.shields.io/badge/macOS-relay%20app-000000?logo=apple&logoColor=white&style=flat-square">
    <img alt="Linux-relay" src="https://img.shields.io/badge/Linux-relay%20app-FCC624?logo=linux&logoColor=black&style=flat-square">
    <img alt="Kotlin" src="https://img.shields.io/badge/Kotlin-Android-7F52FF?logo=kotlin&logoColor=white&style=flat-square">
    <img alt="Electron" src="https://img.shields.io/badge/Electron-desktop%20relay-47848F?logo=electron&logoColor=white&style=flat-square">
  </p>
  <p>
    <a href="https://github.com/Ryan-Laws/easycodex/releases/latest"><strong>Download the latest EasyCodex release</strong></a>
    ·
    <a href="https://github.com/Ryan-Laws/easycodex/releases">All releases</a>
  </p>
</div>

EasyCodex lets you control local Codex work from a desktop relay app and an Android phone. The relay runs on your computer beside your repositories, starts and supervises `codex app-server`, and exposes a secure QR/deep-link pairing flow so the phone can follow and steer the same work without moving source code or credentials to a hosted service.

The current app is a full control room: create and resume Codex sessions, stream conversation updates, answer approvals and user-input prompts, send attachments, review plans and diffs, commit selected files, browse projects and worktrees, archive tasks, run multi-window Codex CLI consoles, use quick replies/emoji/voice input from the phone, receive and tune notifications, check updates, and keep task lists synced as Codex thread state changes.

## Why EasyCodex

OpenAI now offers Codex remote access inside the ChatGPT mobile app, currently as a preview for connecting mobile ChatGPT to Codex hosts. EasyCodex focuses on a different path: a local-first relay you own, with broader desktop host support and no hosted control plane between your phone and your development machine.

| Area | EasyCodex | OpenAI Codex mobile preview |
| --- | --- | --- |
| Desktop host platforms | Windows, macOS, and Linux relay builds | OpenAI's May 14, 2026 release notes say mobile remote access currently connects to Codex running on macOS; OpenAI's blog says Windows mobile connection support is coming soon |
| Phone pairing | QR/deep-link pairing to your own relay with a local API key | Runs inside the ChatGPT mobile app and uses your ChatGPT/OpenAI account |
| API/provider flexibility | The phone does not hard-code a provider login; the relay follows the Codex CLI configuration already authenticated on your computer, including compatible non-OpenAI setups when your local Codex environment supports them | Tied to OpenAI's ChatGPT/Codex account experience |
| Data path | Phone talks to your desktop relay over your trusted LAN or private network; repositories and credentials stay on the host machine | Uses OpenAI's authorized ChatGPT device and relay infrastructure |
| Workflow scope | Mobile approvals, diffs, Git status, selected-file commits, project/worktree browsing, attachments, local CLI consoles, and a desktop relay workbench | Mobile start/continue threads, approvals, direction changes, host switching, and live context from connected Codex hosts |

Sources for the current OpenAI behavior: [OpenAI product post](https://openai.com/index/work-with-codex-from-anywhere/) and [ChatGPT release notes](https://help.openai.com/en/articles/6825453-chatgpt-release-notes).

## Install

Download the current release from the [latest EasyCodex release](https://github.com/Ryan-Laws/easycodex/releases/latest).

| Platform | Download | What it is for |
| --- | --- | --- |
| Windows | `EasyCodex.Relay.Setup.*-x64.exe` | Recommended Windows desktop relay installer |
| Windows | `EasyCodex.Relay.Portable.*-x64.exe` | Portable Windows relay app |
| Android | `EasyCodex.Mobile.*.apk` | Android phone app |
| macOS Apple Silicon | `EasyCodex.Relay.*.mac-arm64.dmg` | Apple Silicon desktop relay |
| macOS Intel | `EasyCodex.Relay.*.mac-x64.dmg` | Intel desktop relay |
| Linux | `EasyCodex.Relay.*.linux-x64.AppImage` | Portable Linux relay app |
| Linux | `EasyCodex.Relay.*.linux-x64.deb` | Debian/Ubuntu relay package |

## Quick Start

1. Install the Codex CLI on your computer and make sure it is authenticated.
2. Install and open **EasyCodex Relay** on your desktop.
3. Choose a default workspace, confirm the port/API key, and start the relay.
4. Install `EasyCodex.Mobile.*.apk` on your Android phone.
5. Scan the QR code or open the `easycodex://connect` deep link.
6. Pick a workspace or worktree, then create or resume a Codex task.

The phone does not run Codex. It connects to the relay over an authenticated WebSocket. The relay launches `codex app-server` for agent sessions and `codex exec` for mobile CLI windows.

Desktop handoff and mobile-originated tasks are intentionally different modes. When the phone resumes an existing Codex thread, the desktop Codex App remains the primary UI. When the phone starts a new task, the relay-owned `codex app-server` session is the primary UI; the desktop Codex App may discover some history through shared Codex state, but it is not expected to show every app-server or sub-agent detail.

## What You Can Do

- Start, resume, interrupt, stop, and archive Codex tasks.
- See running agents, active Codex threads, historical threads, queued follow-ups, and unread completed work.
- Send text, images, and files from the phone; attachments are stored under the selected workspace in `.easycodex-attachments/`.
- Use quick replies, emoji insertion, and Android system voice input while composing prompts.
- Review plans before execution and ask Codex to optimize them.
- Inspect Git status/diff, preview changed files, and commit selected files.
- Browse allowed workspaces, trusted directories, relay-managed repos, and Git worktrees.
- Answer Codex approval prompts and structured user-input prompts; main agents support default review, Codex auto-review, and full access modes, with full access suppressing permission approval prompts.
- Open multiple mobile CLI windows backed by separate `codex exec` runs, including resume/review modes, profiles, images, extra directories, JSON output, ephemeral runs, ignore-rules, sandbox, and Git-repo-check toggles.
- Choose model, reasoning effort, service tier, cwd, main-agent permission mode, CLI sandbox mode, and update channel where supported.
- Receive local app notifications and optional mobile push notifications, with per-agent notification levels and recent notification history.
- Check stable/beta APK updates from the Android app and relay/installer updates from the desktop relay.
- Use the desktop relay workbench to monitor tasks, read conversations, send follow-ups, answer approvals, and inspect Git status/diff without opening the phone.

## Architecture

```text
Android app / Desktop workbench
        <-> Agent Relay
        <-> codex app-server / codex exec
        <-> Codex thread state
```

The relay authenticates clients with a local API key, validates workspace paths, starts Codex processes, translates Codex JSON-RPC events into stable app messages, and exposes explicit file/Git/workspace actions.

## Requirements

- A desktop computer for the relay
- An Android phone or emulator for the mobile app
- Codex CLI installed and authenticated on the desktop computer
- Phone and computer on the same trusted network, or connected through a private network such as Tailscale

## Build From Source

Most users should install from the release page. Use these commands when developing EasyCodex itself.

```powershell
# Desktop relay
Set-Location desktop-relay
npm install
npm start

# Agent relay
Set-Location agent-relay
npm install
npm run build

# Android app
Set-Location mobile
gradle assembleDebug
```

## Repository Layout

```text
EasyCodex/
├── mobile/          Native Android app
├── agent-relay/     Node.js Agent Relay for Codex
├── desktop-relay/   Electron desktop relay app
└── scripts/         CLI and local setup helpers
```

## Security Model

- The relay requires an API key for WebSocket clients and health checks.
- Treat relay access as powerful: it can read workspace files, inspect Git state, commit selected files, and launch Codex in a working directory.
- Workspace access is limited to known/trusted roots; the relay refuses obvious system/profile/application-data roots.
- Prefer a trusted LAN or private network for day-to-day use.
- Never commit API keys, relay keys, OpenAI tokens, local agent state, or private environment files.

## Documentation

- [文档.md](文档.md) is the Chinese project overview.
- [View.md](View.md) maps Android and desktop user-facing views.
- [AGENT.md](AGENT.md) describes relay-managed Codex agents, WebSocket actions, stream events, and runtime behavior.
- [APP.md](APP.md) explains the app architecture and local runtime model.
- [RELEASE.md](RELEASE.md) documents CI/CD release builds, signing, and smoke tests.
- [desktop-relay/README.md](desktop-relay/README.md) covers desktop relay packaging.

## License

EasyCodex is released under the [MIT License](LICENSE).

easycodex

easycodex Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

easycodex

easycodex Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README