Back to search
codex-phone-lab
SkillWorks with CodexGitHub
Codex skill for building Expo apps live on a real phone
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Checked today
Badge for your README
Markdown
[](/listings/kappaemme-git--codex-phone-lab)HTML
<a href="/listings/kappaemme-git--codex-phone-lab"><img src="/api/listings/kappaemme-git--codex-phone-lab/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 102 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # Codex Phone Lab
- Prompt to phone app.
- `codex-phone-lab` installs a Codex skill that helps Codex create Expo/React Native apps and open them on a real iPhone or Android device through Expo Go.
- No Xcode setup. No TestFlight. No App Store wait.
- ```bash
- npx --yes codex-phone-lab
- ```
- Then use it in Codex:
- ```text
- Use $codex-phone-lab and make me a notes app for my phone.
- ```
- ## What It Does
- - Checks the local Node/npm/Expo environment.
- - Creates Expo SDK 54 apps by default so they work with the current Expo Go workflow.
- - Starts the Expo phone preview server.
- - Shows the QR flow for Expo Go.
- - Guides Codex to build real mobile screens instead of generic landing pages.
- - Keeps the live loop: prompt, code, phone refresh.
- ## Why
- Codex can write mobile code, but the phone loop is usually the slow part.
- This skill packages the workflow:
- ```text
- prompt -> Expo app -> QR code -> real phone -> live edits
- ```
- It is meant for quick MVPs, app ideas, prototypes, demos, and internal tools.
- ## Requirements
- - Node.js and npm.
- - Expo Go installed on your iPhone or Android phone.
- - Phone and computer on the same Wi-Fi for LAN mode.
- If LAN mode fails, use tunnel mode:
- ```bash
- ~/.codex/skills/codex-phone-lab/scripts/start-phone-preview.sh tunnel
- ```
- ## Commands
- After installation, the skill lives at:
- ```text
- ~/.codex/skills/codex-phone-lab
- ```
- Create a new Expo app:
- ```bash
- ~/.codex/skills/codex-phone-lab/scripts/new-expo-app.sh my-phone-app
- ```
- Start the phone preview:
- ```bash
- cd my-phone-app
- ~/.codex/skills/codex-phone-lab/scripts/start-phone-preview.sh lan
- ```
- Run a quick environment check:
- ```bash
- ~/.codex/skills/codex-phone-lab/scripts/doctor.sh
- ```
- ## Expo SDK Version
- The skill defaults to:
- ```text
- expo-template-default@sdk-54
- ```
- This avoids the common Expo Go error:
- ```text
- Project is incompatible with this version of Expo Go
- ```
- Override the template only when your Expo Go supports a newer SDK:
- ```bash
- CODEX_PHONE_LAB_EXPO_TEMPLATE=expo-template-default@sdk-55 \
- ~/.codex/skills/codex-phone-lab/scripts/new-expo-app.sh my-app
- ```
- ## License
- MIT
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.