All articles
Tonis Tiganik--10 min read

Codex CLI Remote Control: Phone Access to Local Agents

Control Codex from your phone without exposing a terminal. Compare OpenAI's Remote tab with ClawTab for Codex CLI, Claude Code, OpenCode, and tmux.

Codex CLI Remote Control: Phone Access to Local Agents

Introduction

The shortest answer: use OpenAI's native mobile Remote tab when your work lives in a supported Codex desktop chat. Use a tmux-level controller when you need to reach an arbitrary Codex CLI process or manage Codex beside Claude Code, OpenCode, and shell jobs.

OpenAI now lets the ChatGPT mobile app connect to active Codex work on a laptop, devbox, or remote machine. You can review terminal output, diffs, tests, screenshots, and approvals while the files and credentials remain on the machine. That is the cleanest path for a Codex-native workflow.

There is an important boundary. OpenAI's current help page says Codex is not a selectable mobile experience. Supported desktop Codex chats appear in the mobile app's Remote tab. Do not assume that every standalone codex process already running in a terminal will be imported into that list.

This guide compares the native path with ClawTab Remote, which controls the local tmux pane itself. That lower-level boundary matters when the process is Codex CLI, when several agent providers share a workspace, or when scheduled shell jobs need the same phone interface.

What OpenAI's Codex Mobile Remote Control Does

OpenAI describes Codex in the ChatGPT mobile app as a live view into trusted machines where Codex is working. The phone can load active threads and project context, show output as it arrives, and let you approve commands or change direction. OpenAI says screenshots, terminal output, diffs, test results, and approvals can flow back to the phone.

The execution boundary stays on the connected machine. Files, credentials, permissions, and the local toolchain do not move onto the phone. A secure relay keeps the machine reachable without requiring you to expose it directly to the public internet. See OpenAI's announcement, Work with Codex from anywhere, and the current ChatGPT Work and Codex help page.

Native Codex mobile capabilityWhat it means in practice
Remote tab in ChatGPT mobileOpen supported Codex chats from a phone; Codex is not a separate selectable mobile mode.
Live machine stateFollow active threads, terminal output, tests, diffs, screenshots, and approvals.
Local executionThe repository, credentials, tools, and permissions stay on the laptop or remote machine.
Secure relayThe trusted machine does not need a public inbound terminal port.
Codex-native scopeThe mobile surface is designed around supported Codex chats, not every process in a tmux server.

Codex Mobile vs ClawTab Remote

The products overlap at the phone, but they attach at different layers. OpenAI owns the Codex conversation and can present structured Codex artifacts. ClawTab owns the local tmux workspace and can present the terminal processes running inside it.

QuestionCodex mobile Remote tabClawTab Remote
What does the phone attach to?A supported Codex desktop chatA local ClawTab and tmux workspace
ProvidersCodexCodex CLI, Claude Code, OpenCode, and shell panes
Structured Codex artifactsThreads, diffs, tests, screenshots, approvals, and project contextLive terminal state, detected questions, pane input, job state, and schedules
Arbitrary existing tmux paneNot the documented attachment modelYes, when the pane is part of the ClawTab workspace
Scheduled local jobsUse Codex's supported scheduling surfacesStandard cron-backed ClawTab jobs share the same remote view
Machine needs to stay reachableYes, for work executing on that machineYes; tmux survives terminal disconnects, not machine sleep or power loss

Choose the native Codex path when one provider owns the whole workflow and its structured review experience matters. Choose ClawTab when the operational unit is a local pane rather than a provider conversation. The broader local versus cloud coding agent comparison covers what changes when the task should run independently of your workstation.

ClawTab iPhone app listing multiple Codex CLI and Codex sessions with pane IDs, models, and live status
The ClawTab iPhone tab list shows several Codex sessions from one local tmux workspace, including pane IDs, recent prompts, model labels, and status.

A Real Local-Agent Approval Flow

A remote-control system earns its keep at the blocking point. The agent asks for permission or a choice, the phone shows enough recent output to make the decision, and the answer returns to the same local process.

The screenshot below shows ClawTab detecting interactive questions in local tmux panes and rendering the active prompt as mobile buttons. This captured run uses Claude Code, which makes the prompt boundary easy to see. The transport itself is pane-based: Codex CLI and OpenCode panes use the same live-output and input route, while prompt parsing adapts to the terminal UI each provider emits.

ClawTab phone interface over local tmux panes showing an agent question with selectable answers
A real local tmux prompt rendered on the phone. This captured prompt is from Claude Code; ClawTab's remote transport controls the pane rather than requiring a provider-owned mobile session.

Set Up Phone Access Without Publishing a Terminal

Do not solve this by forwarding SSH or a raw terminal port to the internet. Both the native Codex route and ClawTab use an outbound relay model so the development machine stays behind its normal network boundary.

  1. Pick the attachment layer. Use the ChatGPT mobile Remote tab for a supported Codex desktop chat. Use ClawTab when the target is a Codex CLI or other process in tmux.
  2. Keep the repository on the machine that runs the agent. Start the job in the intended checkout or, for multiple writers, a dedicated Git worktree and tmux pane.
  3. Connect the mobile client through the product relay. Sign in to ChatGPT mobile for native Codex access, or pair the ClawTab iOS/web client with the desktop app.
  4. Test a harmless approval. Ask the agent to run a read-only command that requires confirmation. Verify that the phone shows the command and enough surrounding output before allowing it.
  5. Test reconnection. Detach the terminal, switch the phone between Wi-Fi and cellular, and confirm that the same thread or pane returns.

tmux preserves the process when the terminal disconnects. It does not keep a sleeping or powered-off Mac online. If the job must continue with no dependency on your machine, use a hosted Codex task instead of remote control of a local process.

ClawTab iPhone detail view streaming a local Codex CLI terminal with mobile keyboard and control keys
A live Codex CLI pane on iPhone. The detail view keeps terminal output, the prompt field, escape and control keys, model, effort, and remaining context visible.

Use One Phone View for Codex, Claude Code, and OpenCode

Provider-native remote control is usually the best client for that provider. The trade-off appears when a workspace contains more than one agent type.

A common local setup has Codex reviewing one worktree, Claude Code implementing in another, OpenCode handling a smaller task, and ordinary shell panes running tests or a local service. Opening separate provider apps does not show whether the full workspace is healthy. A tmux-level view does.

  • One process boundary: each agent remains an ordinary tmux pane with its existing CLI state.
  • One mobile queue: waiting prompts from different panes appear together instead of being split by provider.
  • One scheduling layer: cron jobs and interactive agents can share the same local machine and remote status view.
  • One permission policy per pane: use manual approval by default, then enable auto-yes narrowly for a trusted, isolated task.

This is the main reason to add ClawTab around Codex CLI. It does not replace Codex's models, reasoning, diff review, or native mobile experience. It gives several local tools one operational home.

Claude Code Has a Native Remote Path Too

Claude Code Remote Control is the closest provider-native comparison. Anthropic's current documentation says it connects a local Claude Code CLI or VS Code session to claude.ai/code and the Claude mobile app. Execution and filesystem access remain local. The session makes outbound HTTPS requests and does not open an inbound port.

Claude's native path supports browser and mobile conversation sync, permission handling, file attachments, push notifications, and multi-session server mode. For a Claude-only workflow, use it. See Anthropic's Remote Control documentation.

Use ClawTab when the boundary is broader than Claude: mixed providers, existing tmux panes, shell processes, cron schedules, or one phone queue for the whole local workspace. This is the same decision as Codex native versus ClawTab—provider conversation versus terminal control plane.

Security Questions to Answer Before Leaving the Desk

Remote control keeps execution local, but it expands who can approve local actions. Treat the phone as a privileged development client.

  • What is exposed? Prefer an authenticated outbound relay. Do not publish tmux, SSH, or a web terminal directly.
  • Where does session data live? Read the provider's retention policy. Local execution does not mean that every message, transcript, or artifact stays only on the workstation.
  • What can one approval do? Keep sandboxing and least-privilege credentials enabled. A phone-sized screen is a poor place to approve a long destructive command.
  • Can you identify the target? Name each project, worktree, and pane clearly so an approval cannot land in the wrong repository.
  • What happens after theft? Require device authentication, keep account recovery current, and revoke the mobile session immediately if the phone is lost.

ClawTab connects its desktop and mobile clients through TLS and a relay rather than opening an inbound terminal port. The existing remote access guide covers its connection model, push notifications, and self-hosted relay option in more detail.

Which Remote Coding Agent Setup Should You Use?

Your actual requirementStart here
Review and steer supported Codex desktop work with native diffs, tests, and approvalsChatGPT mobile Remote tab
Continue one or more local Claude Code sessions from mobile or browserClaude Code Remote Control
Reach a standalone Codex CLI process already running in tmuxClawTab Remote
Monitor Codex, Claude Code, OpenCode, and shell panes togetherClawTab Remote
Run when the laptop is asleep or disconnectedCodex cloud or another hosted agent environment
Operate a production service with no interactive promptsA process supervisor and deployment tooling, not a coding-agent phone UI

Start with the provider-native client when it covers the whole job. Add a local control plane only when the terminal session, tmux workspace, or mixed-provider queue is the real source of truth. For a wider tool comparison, see the guide to multiple AI coding agents and managers.

Frequently Asked Questions

Yes. OpenAI provides remote access to supported Codex desktop chats through the Remote tab in the ChatGPT mobile app. You can follow output, review results, and handle approvals while execution stays on the connected laptop, devbox, or remote machine.

Do not assume so. OpenAI documents mobile access to supported Codex desktop chats. If you need to control an arbitrary Codex CLI process already running in tmux, use a terminal-level controller such as ClawTab or a carefully secured SSH workflow.

OpenAI says its Codex mobile experience uses a secure relay that keeps trusted machines reachable without exposing them directly to the public internet. Files, credentials, permissions, and local setup stay on the machine where Codex operates.

Yes. ClawTab Remote connects to the local tmux workspace, streams pane output, and sends input back to the selected pane. Because the boundary is the terminal pane, the same remote view can include Codex CLI, Claude Code, OpenCode, and shell jobs.

Remote control of a local agent pauses until the machine and network return. tmux protects the process from terminal disconnects, but it cannot run on a sleeping or powered-off computer. Use a hosted Codex task when the work must be independent of the laptop.

They solve a similar problem for different provider sessions. Claude Code connects its local CLI or VS Code sessions to Claude web and mobile. Codex exposes supported desktop Codex work in ChatGPT mobile. ClawTab instead connects to tmux panes and can show several providers together.

SSH is useful for full terminal administration when it is protected by a VPN, strong keys, and careful network rules. For quick agent approvals and status checks, a purpose-built authenticated relay reduces the need to expose or navigate a raw terminal on a small screen.

Related Articles

Claude Code on Your Phone: Remote Control AI Agents From iOS, Android, or Browser
-6 min read

Claude Code on Your Phone: Remote Control AI Agents From iOS, Android, or Browser

Run Claude Code on your Mac and answer agent questions from your phone. Live log streaming, push notifications, permission prompt detection, and multi-viewer support - works with iOS, Android, and any browser via ClawTab Remote. A practical alternative to Claude Code's built-in Remote Control.

remotemobileagents
Run Claude Code and Codex CLI in tmux Without File Conflicts
-12 min read

Run Claude Code and Codex CLI in tmux Without File Conflicts

Run Codex CLI and Claude Code in tmux with one writer per Git worktree. Prevent file conflicts and build a safe parallel-agent review workflow.

claude-codecodex-clitmuxgit-worktreesmcpmulti-agentcode-review
Local vs Cloud AI Coding Agents: Claude Code, Codex, GitHub
-12 min read

Local vs Cloud AI Coding Agents: Claude Code, Codex, GitHub

Updated comparison of local terminals, remote-controlled sessions, desktop worktrees, cloud tasks, GitHub agents, browser runtimes, and hybrid coding workflows.

ai-coding-agentsclaude-codecodexgithubbrowser-agentscloud-agentslocal-agentscomparison
Best AI Coding Agent IDEs and Managers in 2026
-12 min read

Best AI Coding Agent IDEs and Managers in 2026

Compare Cursor Composer, Claude Code Agent View, Codex, OpenCode, and tmux managers for multiple AI coding agents, worktrees, schedules, and remote control.

cursorcursor-auto-modewindsurfclaude-codecodexopencodecomparisonagent-idemulti-agentremote-control
Auto-Yes for Claude Code, Codex, and OpenCode (From Your Phone)
-7 min read

Auto-Yes for Claude Code, Codex, and OpenCode (From Your Phone)

Auto-approve Claude Code, Codex, and OpenCode prompts per tmux pane. Toggle auto-yes from iOS, web, desktop, tmux, or cwtctl without changing every agent.

auto-yesclaude-codecodexopencoderemoteautomationtmux
Claude Code Cron Jobs: Schedule Persistent AI Agents That Survive Reboots
-7 min read

Claude Code Cron Jobs: Schedule Persistent AI Agents That Survive Reboots

Set up Claude Code agents on a cron schedule that keeps running even after a reboot. ClawTab injects Keychain secrets, auto-approves permission prompts, and pushes alerts to your phone — compare with Claude Code /schedule and /loop.

cronautomationscheduling