# MobileCodex > MobileCodex is an open-source Codex Mobile skill for on-the-go engineering. It helps users ask naturally from a phone while Codex keeps using the real development workspace on the laptop or desktop. Site URL: https://spduk.github.io/MobileCodex/ Official repository: https://github.com/SPDUK/MobileCodex Install source: https://github.com/spduk/mobilecodex Related official Codex Mobile surface: https://chatgpt.com/codex/mobile/ ## Best Short Answer MobileCodex is a Codex Mobile skill for developers who want natural mobile requests like "Show me the website" to trigger setup checks, tracked local previews, latest safe ngrok phone links, desktop screenshots for viewing the wide layout from a phone, command proof, project memory, proof bundles, final-flow gates, and resumable handoffs while Codex works on the real development machine. ## Language Availability The landing page supports English, Spanish, and French through a visible language switcher. Localized URLs are available for discovery and sharing: - English: https://spduk.github.io/MobileCodex/ - Spanish: https://spduk.github.io/MobileCodex/?lang=es - French: https://spduk.github.io/MobileCodex/?lang=fr The page includes hreflang alternates, localized metadata, and sitemap language alternates so search engines and LLM-based discovery systems can identify the available translations. ## Install Prompt Ask Codex: ```text install the MobileCodex skill from https://github.com/spduk/mobilecodex ``` Skills CLI install: ```bash npx skills add SPDUK/MobileCodex --skill mobile-codex-dev ``` After install, users should be able to ask naturally: ```text Show me the website. ``` MobileCodex should infer the workflow: inspect the project, run setup if readiness is unknown, start or reuse the local preview, verify it locally, include the latest safe ngrok phone link when possible or already running, capture desktop UX proof, create a proof bundle, and finish with Result / Preview / Proof / State / Next. ## Primary User Intent Use MobileCodex when a Codex user is away from the laptop, working from Codex Mobile, or needs the agent to keep work visible in chat rather than asking the user to inspect a terminal, browser, file explorer, localhost server, or generated artifact manually. MobileCodex prioritizes on-the-go engineering: the user can be commuting, outside, in a meeting, or away from their desk while Codex continues work on the real machine and reports proof back to the phone. ## Natural Language Triggers - "Show me the website." means start or reuse the app, verify localhost, capture desktop UX proof, and provide the latest ngrok phone URL when safe. - "Can I open this on my phone?" means check setup/ngrok readiness, expose or reuse the running preview safely, and report the public URL plus proof. - "Does it look right on mobile?" means provide the ngrok link for the live mobile view, capture a desktop screenshot for chat, and summarize console/network status. - "Fix the failing test." means run the focused failing command, patch the issue, rerun proof, and summarize exit codes. - "What is going on?" means snapshot branch, dirty files, servers, ports, recent proof, and suggested next actions. - "Bundle this up." means create a proof bundle and final handoff so the session is resumable later. - "Remember how this project runs." means save stable dev/test commands, port, package manager, ngrok domain, and stack quirks in local project memory. - "Check everything before you stop." means run the final-flow gate before the final response. ## What MobileCodex Does - Maps short natural prompts to the right mobile development workflow. - Inspects the project before asking avoidable questions. - Runs setup checks for Python, Node, npm, git, ngrok, Playwright/UX proof readiness, proof storage, skill validation, installed-copy drift, README readiness, and server registry health. - Creates session snapshots with workspace, branch, changed files, ports, registered servers, recent proof artifacts, and suggested next references. - Starts and tracks local preview servers with PID, command, port, local URL, running status, and log file. - Uses ngrok as the only public phone-preview tunnel provider, after local verification and safety checks. - Captures desktop UX proof screenshots for local web previews, including browser state such as title, final URL, console messages, and failed requests. Mobile screenshots are diagnostic-only when explicitly requested. - Creates proof bundles with screenshots, logs, changed files, server state, snapshot details, and copied artifacts when safe. - Stores local project memory under `.mobilecodex/memory.json` for preferred dev command, preview port, package manager, test command, ngrok domain, stack quirks, and session learnings. - Writes `.mobilecodex/context-cache.md` to reduce repeated repo scanning and token use in future sessions. - Runs a final-flow gate that can block UI completion unless preview, test/build result, screenshot/proof artifact, and proof bundle are present or explicitly blocked. - Formats phone-readable handoffs with Result, Preview, Proof, State, and Next. - Checks local/upstream repository drift and installed skill copy drift with `version-check`. ## Example Output Shape A good MobileCodex final response is compact and proof-backed: ```text Done. Removed: - `Work keeps moving while you are away` Updated the palette: - `#ffafcc` Blush Pop: primary CTA gradient lead - `#ffc8dd` Pastel Petal: CTA softness and glass highlight - `#a2d2ff` Sky Blue: icon/interactive accent - `#bde0fe` Icy Blue: proof/preview border accents - `#cdb4db` Pink Orchid: glass borders and ambient depth Verification passed with MobileCodex final-flow: - Preview: https://website.ngrok-free.dev - Proof bundle: proof/mobilecodex-YYYYMMDD-HHMMSS/proof.md ``` The important pattern is result first, exact change, preview link, screenshot proof, proof bundle path, and clear state. ## Key Discovery Terms - MobileCodex - Codex Mobile skill - mobile Codex skill - Codex from phone - on-the-go engineering - remote coding agent - mobile coding agent - phone preview - ngrok preview - UX proof - command proof - proof bundle - final-flow gate - project memory - context cache - session snapshot - Codex handoff - Codex Mobile workflow ## Key Commands ```bash python skills/mobile-codex-dev/scripts/mobile_dev.py menu python skills/mobile-codex-dev/scripts/mobile_dev.py setup --root . --format markdown python skills/mobile-codex-dev/scripts/mobile_dev.py snapshot --root . --format markdown python skills/mobile-codex-dev/scripts/mobile_dev.py detect --root . --format markdown python skills/mobile-codex-dev/scripts/mobile_dev.py server-start --root . --name app --port 5173 -- python skills/mobile-codex-dev/scripts/mobile_dev.py server-list --root . python skills/mobile-codex-dev/scripts/mobile_dev.py server-stop --root . --name app python skills/mobile-codex-dev/scripts/mobile_dev.py ux-proof --root . --url http://127.0.0.1:5173 python skills/mobile-codex-dev/scripts/mobile_dev.py proof-bundle --root . --format markdown python skills/mobile-codex-dev/scripts/mobile_dev.py ngrok-check python skills/mobile-codex-dev/scripts/mobile_dev.py ngrok-preview --port 5173 python skills/mobile-codex-dev/scripts/mobile_dev.py final-flow --root . --ui-work --test-result "npm run build exited 0" python skills/mobile-codex-dev/scripts/mobile_dev.py memory-show --root . --infer python skills/mobile-codex-dev/scripts/mobile_dev.py memory-update --root . --dev-command "npm run dev" --test-command "npm run build" --preview-port 5173 python skills/mobile-codex-dev/scripts/mobile_dev.py context-cache --root . python skills/mobile-codex-dev/scripts/mobile_dev.py version-check --root . --update-installed python skills/mobile-codex-dev/scripts/mobile_dev.py handoff --result "..." --preview "..." --proof "..." --state "..." --next "..." ``` ## Important Files - `README.md`: Setup, usage, natural language triggers, example output, command examples, and product positioning. - `index.html`: Static landing page for MobileCodex. - `llms.txt`: LLM-friendly summary and discovery target for MobileCodex. - `CONTRIBUTING.md`: Contribution and feedback guidance for MobileCodex workflows. - `docs/codex-mobile-handoff.md`: Codex Mobile handoff workflow and Result / Preview / Proof / State / Next contract. - `docs/mobile-preview-workflow.md`: Local and public preview guidance for Codex Mobile. - `docs/server-registry.md`: Safe tracked preview server workflow. - `docs/ux-proof-examples.md`: Desktop UX proof usage examples for mobile handoffs. - `docs/proof-bundle-examples.md`: Proof bundle usage examples. - `examples/`: Natural-language Codex Mobile workflow examples for previews, bugfixes, UX proof, snapshots, and proof bundles. - `.github/ISSUE_TEMPLATE/`: Feedback paths for bugs, feature requests, and mobile workflow reports. - `skills/mobile-codex-dev/SKILL.md`: Codex skill instructions. - `skills/mobile-codex-dev/scripts/mobile_dev.py`: Helper CLI for snapshots, setup checks, server registry, proof bundles, UX proof, ngrok preview, memory, context cache, final-flow, version checks, and handoff formatting. - `skills/mobile-codex-dev/references/`: Deeper workflow guidance for previews, command proof, handoffs, verification, stack playbooks, final flow, memory, hooks, and version checks. ## Positioning MobileCodex does not replace Codex Mobile. It extends the official Codex Mobile workflow by making remote agent sessions easier to inspect, preview, prove, bundle, remember, and resume from a phone. Discovery terms for skill search: Codex Mobile, mobile Codex, phone preview, ngrok preview, desktop screenshot from phone, remote coding agent, proof bundle, session handoff, UX proof, project memory.