explaingit

ryan-laws/easycodex

Analysis updated 2026-05-18

★ 14KotlinAudience · developerComplexity · 3/5Setup · moderate

TLDR

A phone and desktop app for supervising Codex AI coding agent sessions running on your own machine, without sending code to a hosted service.

Mindmap

mindmap
  root((EasyCodex))
    What it does
      Supervise Codex agents
      Remote control from phone
      Stays local
    Tech stack
      Kotlin
      Electron
      WebSocket
    Use cases
      Review agent plans
      Inspect git diffs
      Approve prompts
    Audience
      Developers
      AI coding users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Monitor and steer AI coding agent sessions from your phone while away from your desk

USE CASE 2

Review and approve agent proposed plans before they run

USE CASE 3

Inspect Git diffs and commit selected files from a mobile interface

USE CASE 4

Run a desktop relay workbench to control agent sessions without a phone

What is it built with?

KotlinElectronWebSocket

How does it compare?

ryan-laws/easycodexcomposablehorizons/material-3-compose-unstyledlyosu/hortay-android
Stars141414
LanguageKotlinKotlinKotlin
Setup difficultymoderatemoderatehard
Complexity3/53/54/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires running the desktop relay alongside Codex and pairing an Android app.

In plain English

EasyCodex is a local-first control room for running and supervising Codex agent sessions (AI coding assistants that work inside your development environment) from both a desktop relay app and an Android phone. The idea is to let you monitor and steer ongoing coding work from your phone without sending your source code or credentials to a third-party hosted service. The system has two pieces. A relay application runs on your desktop alongside your repositories. It starts and manages codex app-server sessions for agent work and codex exec sessions for CLI windows, then exposes an authenticated WebSocket that your phone can connect to. Pairing is done by scanning a QR code or following a deep link. The phone app communicates only with your own relay over your local network. From the phone you can start, resume, interrupt, and archive Codex tasks, stream conversation updates, answer approval prompts, review plans before execution and ask for plan optimization, inspect Git status and diffs, preview and commit selected files, browse workspaces and Git worktrees, send text, images, and files as attachments, and use quick replies, emoji, or Android voice input when composing prompts. A desktop relay workbench provides a similar set of controls without needing the phone. The Android application is built in Kotlin. The desktop relay is built with Electron and ships as installer or portable builds for Windows, macOS Apple Silicon, macOS Intel, and Linux. The full README is longer than what was provided.

Copy-paste prompts

Prompt 1
Help me set up the EasyCodex desktop relay to expose a Codex session over WebSocket
Prompt 2
Show me how to pair my Android phone with EasyCodex using a QR code
Prompt 3
Write a script to start a Codex exec session that EasyCodex can supervise
Prompt 4
Explain how EasyCodex keeps my source code from leaving my machine

Frequently asked questions

What is easycodex?

A phone and desktop app for supervising Codex AI coding agent sessions running on your own machine, without sending code to a hosted service.

What language is easycodex written in?

Mainly Kotlin. The stack also includes Kotlin, Electron, WebSocket.

How hard is easycodex to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is easycodex for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.

Alternatives & similar repos