Codex Mobile Remote Control VMMobile-first Codex Desktop VM setup

Turn an SSH-only Ubuntu VM into a Codex Desktop host that the ChatGPT/Codex mobile app can control.

Get Started

日本語

Mobile control first

Treat real mobile app control as the primary proof, even when the Linux Connections UI is sparse.

VM-ready runbook

Covers Proxmox, SSH access, XFCE, LightDM, qemu-guest-agent, and Codex Desktop launch details.

Repair-oriented checks

Includes diagnostics for feature flags, app-server state, enrollments, logs, and disappearing rows.

Documentation Map

Getting Started: install the skill and prepare inputs.
Usage: run the setup or audit an existing VM.
Troubleshooting: interpret Linux-port edge cases.
v0.1.0 Release Notes: initial public release summary.
Mobile Remote Control Walkthrough: screenshot-backed setup story.

For the raw Skill entry point, see SKILL.md.

Setup Proof

These screenshots show the validated setup. The phone screenshots are the primary proof: the ChatGPT/Codex mobile app is controlling the VM-backed Codex Desktop session. The Proxmox screenshots show VM 101 (codex-ubuntu) running Codex Desktop in the console, plus the node inventory with codex, desktop, remote-control, and ubuntu tags.

ChatGPT/Codex mobile app controlling the VM-backed Codex Desktop session

Second ChatGPT/Codex mobile remote-control proof screenshot

Proxmox console showing Codex Desktop running inside the codex-ubuntu VM

Proxmox node view showing the codex-ubuntu VM with codex, desktop, remote-control, and ubuntu tags