Skip to content

v0.1.0 Release Notes

Codex Mobile Remote Control VM v0.1.0 release header

v0.1.0 is the initial public release of Codex Mobile Remote Control VM. It packages the complete setup path for turning an SSH-only Ubuntu VM into a Codex Desktop host that can be controlled from the ChatGPT/Codex mobile app.

Highlights

  • Mobile control is the primary success criterion, with phone screenshots included as release proof.
  • The Skill entry point guides Codex through Proxmox/SSH inventory, Ubuntu desktop repair, Codex Desktop launch, feature-flag setup, mobile pairing, and handoff.
  • The runbook captures command-level repair steps for XFCE/LightDM, qemu-guest-agent, launcher creation, app-server feature state, enrollment checks, and known Linux-port edge cases.
  • CI validates the Skill package, helper scripts, README links, and VitePress docs build.
  • GitHub Pages publishes bilingual docs for install, usage, troubleshooting, setup proof, and this release.

Shipped Surfaces

  • SKILL.md defines when and how Codex should use this Skill.
  • references/runbook.md provides the operator runbook for Proxmox and SSH-based VM setup.
  • scripts/audit-codex-remote-vm.sh audits an existing VM without changing it.
  • README.md and README.ja.md provide public install, use, validation, and proof sections.
  • docs/ publishes English and Japanese VitePress documentation.
  • assets/screenshots/ and docs/public/screenshots/ include the mobile-control and Proxmox proof images.

Validation

This release was validated with:

  • xmllint --noout assets/icon.svg docs/public/logo.svg assets/release-header-v0.1.0.svg docs/public/releases/release-header-v0.1.0.svg
  • ./scripts/validate.sh
  • GitHub Actions CI on main
  • GitHub Pages deploy on main
  • live fetch checks for the docs site and published screenshot assets

Released under the MIT License.