Macky is a secure mobile client that lets you connect to your Mac's screen and terminal from your iPhone using end-to-end encrypted WebRTC. It supports native shell (Zsh, Bash), Claude Code by Anthropic, Codex by OpenAI, and full remote desktop.

How does Macky connect my iPhone to my Mac?

Macky uses peer-to-peer WebRTC with DTLS-SRTP encryption. A signaling server coordinates the initial handshake, but all screen and terminal data flows directly between your devices without passing through any cloud server.

Yes. Macky uses four layers of security: E2E encrypted WebRTC transport, dual-layer identity verification (account tokens plus a master password), device allow-listing, and blind signaling where screen and terminal data never touches Macky's servers.

Does Macky log my terminal commands?

No. Macky has a zero-logs policy. Terminal commands, output, and screen data are never recorded, stored, or accessible by Macky's servers. All data is end-to-end encrypted between your devices.

What AI tools does Macky support?

Macky supports Claude Code (by Anthropic) and Codex (by OpenAI) in addition to native Zsh and Bash shells and full remote desktop, all accessible from your iPhone.

What are the system requirements for Macky?

The Mac host app requires macOS 15 or later. The iPhone remote app requires iOS 18 or later.

How much does Macky cost?

Macky offers a free Basic plan with 5-minute sessions, 1 Mac host, and 1 iPhone remote. The Pro plan costs $29 as a one-time lifetime payment and includes unlimited sessions, unlimited devices, 30-day connection logs, and background connect.

Why is Codex remote stuck on 'Awaiting approval'?

When Codex prompts for shell command permission, interactive TTY prompts are not always serialized into the mobile web UI, causing the desktop to pause while mobile shows an endless loading spinner.

How do I fix the Codex SQLite WAL lock on Mac?

Terminate lingering processes with 'pkill -9 -f codex' and delete the stale lock files '~/.codex/*.sqlite-wal' and '~/.codex/*.sqlite-shm'.

Can I approve Codex commands from my iPhone?

Yes. By streaming your Mac terminal directly through Macky, every interactive prompt and diff appears in real time, and you can approve commands with one tap using the accessory keyboard.

August 24, 20265 min read

OpenAI Codex Remote Control: Fix "Awaiting Approval" Hangs & Pairing Bugs

Download for Mac Download for iOS

OpenAI Codex and its terminal agent wrappers allow developers to run multi-step code generation, automated refactors, and test suites directly from their command line. Remote pairing features let you walk away from your desk while the agent writes code.

However, two infuriating bugs plague developers using remote Codex sessions: the infamous “Awaiting approval” mobile freeze (where the agent waits for a confirmation that never appears on your phone) and the stuck pairing QR code caused by SQLite database locks.

Here is a technical diagnosis of why these bugs happen, how to resolve them immediately on macOS, and how to get an uninterrupted mobile terminal experience.

Issue	What Happens	Resolution
Mobile “Thinking...” Freeze	Desktop terminal asks for approval, but mobile UI hides the prompt	Run non-interactive flag or use native Mac PTY stream
QR Pairing Hangs Indefinitely	SQLite Write-Ahead Log lock (`state_5.sqlite-wal`)	Clear orphaned processes and reset WAL files

Bug 1: The “Awaiting Approval” Ghost Prompt on Mobile

When Codex prompts for permission to execute a shell script, some command wrappers fail to serialize the interactive TTY prompt into the mobile schema. Because the mobile app only renders recognized event types, the approval prompt never appears on your phone. The agent pauses indefinitely waiting for host input.

Workaround inside Codex CLI:

codex --auto-approve-commands --dangerously-skip-permissions

Caution: Skipping permission prompts means the AI agent can run arbitrary shell commands and delete files without human confirmation.

Bug 2: SQLite WAL Lock Freezing QR Code Pairing

Codex maintains local session state in an embedded SQLite database (~/.codex/state_5.sqlite). When a previous session crashes, SQLite enters a Write-Ahead Logging (WAL) deadlock.

How to clear the lock on macOS:

pkill -9 -f codex rm -f ~/.codex/*.sqlite-wal ~/.codex/*.sqlite-shm

The Clean Fix: Stream the Actual Terminal via Macky

With Macky, you stream your Mac's raw interactive terminal directly to your iPhone via WebRTC.

Zero Ghost Prompts: Every prompt, confirmation, and diff appears verbatim in real time.
One-Tap Approvals: Tap y and Enter on Macky's custom mobile accessory toolbar.
True Background Continuity: Sleep your phone or switch networks without dropping agent processes.

Related Guides & Comparisons

5 min read

Claude Code Remote Control Not Working: Fix /rc Disconnects & Sleep Bugs

Read guide →

5 min read

Antigravity Remote Session: Fix "Secret Keyring is Locked" & Headless OAuth Bugs

Read guide →

5 min read

Best iPad Terminal Apps in 2026: 5 Tools for Developers

Read guide →

Try Macky

Connect to your Mac terminal from your iPhone. Free to start, no configuration required.

Download for Mac View Pricing

←All Posts