Mobile Codex — run Codex directly on Android, no remote PC required

[nokryong]

I wanted to use Codex on my phone to work with files stored on the device. Setting up and using a terminal on a small screen felt awkward, so I built Mobile Codex, an Android app around the Codex engine.

Mobile Codex bundles an Android port of Codex and connects its mobile UI through the app-server JSON-RPC interface. It uses Codex’s ChatGPT device-code login flow. The agent process and file tools run on the phone; model inference still requires OpenAI’s servers.

No separate PC server or Termux installation is needed.

Features include:

• Project-based conversations and file attachments
• Local file editing and bundled Git, Python, and Node.js
• Image generation, including custom-skill workflows, with in-chat previews and downloads
• Custom skills, plugins, and MCP configuration
• Optional phone controls through Android accessibility permissions

This is an unofficial personal project, currently in alpha for ARM64 devices running Android 10 or later. You’ll need an internet connection and an account with Codex access.

I’d appreciate feedback on installation, mobile usability, and the app-server integration.

• Source code and build instructions
• Download the APK

The README includes installation instructions and known Android limitations.

The screenshots below show general chat, cloning this repository onto the phone, selecting a custom skill, and generating an image using that skill.

[v31null]

Great work nokryong !