@quantiya/codevibe-codex-plugin

CodeVibe for OpenAI Codex CLI

Control OpenAI Codex CLI from your iPhone and Android. See your agent's work, approve file edits, dictate prompts by voice — all from your phone, anywhere you are.

🌐 quantiya.ai/codevibe — landing page, demo video, and one-liner installer

📱 Download on the App Store · Get it on Google Play

Why CodeVibe for Codex CLI

• 🚀 Real-time sync — every prompt, response, shell command, and file patch shows up on your phone in 100–500ms
• ✅ Approve from anywhere — review full file diffs and approve or reject file edits from your phone
• 🧠 Reasoning visibility — see Codex's thinking/reasoning alongside its output
• 🎙️ Voice prompts — dictate your next prompt with speech-to-text
• 📷 Image attachments — send screenshots and photos; downloaded locally for Codex to reference
• 🔔 Push notifications — get notified when your agent needs input
• 🔒 End-to-end encrypted — AES-256-GCM with ECDH key exchange
• 🔓 Locked screen support — works even when your computer screen is locked (via tmux)
• 🧠 Multi-agent ready — Codex sessions appear alongside Claude and Gemini sessions in the same app

Install in 30 seconds

curl -fsSL https://quantiya.ai/codevibe/install.sh | bash

Download the iOS app or Android app, sign in with the same Apple or Google account, and run:

codevibe-codex

Your session appears on your phone automatically.

Manual install

npm install -g @quantiya/codevibe
codevibe login
codevibe-codex

Requirements

• macOS, Linux, or WSL Ubuntu — Windows without WSL is not supported
• Node.js 18.0.0+
• tmux — brew install tmux on macOS, apt install tmux on Linux/WSL
• Codex CLI installed and authenticated

How it works

Codex CLI writes session logs to ~/.codex/sessions/ as JSONL files. CodeVibe watches those files with chokidar, parses every log entry, and streams it through E2E-encrypted AWS AppSync to your phone.

Approval prompts (Codex's interactive Y/N confirmations) aren't in the JSONL log, so CodeVibe observes the live tmux pane to detect them — you get real prompts with real options, and your mobile approve/reject is sent back via tmux send-keys.

Each live Codex process appears as its own session on your phone, so you can run multiple concurrent Codex sessions side-by-side with Claude and Gemini.

What gets synced

Direction	What
Desktop → Mobile	User prompts, assistant responses, agent reasoning, shell commands, file edits (apply_patch), tool outputs, approval prompts, images
Mobile → Desktop	Text prompts and approval responses executed via tmux

CLI commands

codevibe-codex              # Start Codex with mobile sync
codevibe-codex "fix bug"    # Start with an initial prompt
codevibe-codex login        # Authenticate via browser OAuth
codevibe-codex status       # Check auth status
codevibe-codex logout       # Sign out

Troubleshooting

# Check server logs
tail -f /tmp/codevibe-codex-mcp.log

# Verify session logs exist
ls -la ~/.codex/sessions/$(date +%Y)/$(date +%m)/$(date +%d)/

# Verify tmux session
tmux list-sessions | grep codevibe-codex

# Reinstall if needed
codevibe update

Support

• Email: [e-mail]
• Landing page: quantiya.ai/codevibe
• Privacy policy: quantiya.ai/privacy

Part of the CodeVibe family

• @quantiya/codevibe — meta-package (install this, not this plugin directly)
• @quantiya/codevibe-core — shared library used by all plugins
• @quantiya/codevibe-claude-plugin — Claude Code support
• @quantiya/codevibe-gemini-plugin — Gemini CLI support

License

MIT