Skip to content

// guides

Codex CLI on iPad: 4 Ways to Run It

You can run Codex CLI on an iPad today, but not directly on iPadOS. The fastest path is Cosyra on the App Store — the same iOS app runs natively on iPad Pro, iPad Air, and iPad mini, and the Ubuntu container it provisions has OpenAI's codex CLI already installed. Pair a Magic Keyboard, paste your OpenAI API key, type codex, and the agent is up. Sign up gets you 1 hour free, no credit card. The three other real options — Codex Web in Safari, the ChatGPT app's remote-control feature, and SSH from Blink Shell — are covered below, because picking the wrong one is easy when four different things now share the "Codex" name.

This guide is the iPad-specific companion to our Codex CLI on your phone walkthrough. The phone version covers iPhone and Android generically, the Codex CLI on iPhone guide walks the four iPhone-specific paths (including the ChatGPT-app remote), and the Codex CLI on Android guide goes deep on the Termux-plus-SSH path that only Android supports. This one focuses on what changes when the screen gets bigger: Magic Keyboard, Split View, Stage Manager, and the way an iPad plus a real keyboard turns into a serious coding client. If you want the broader picture of all four AI agents on mobile, start there. If you are weighing Codex against Anthropic's agent, our Claude Code vs Codex CLI comparison lines them up command by command, and our Claude Code on iPad guide is the sibling to this one for the same form factor.

Quick decision. Jump to the part that matches your situation:

  • I want Codex CLI actually running, no Mac at home. Cloud container, native iPad app, three-minute setup. Cosyra iPad setup ↓
  • I already have a Mac running Codex. The ChatGPT app can steer it from your iPad — a different thing from running it. The four ways compared ↓
  • I just want the cloud agent with no install. Codex Web at chatgpt.com/codex renders fine in iPad Safari. Codex Web option ↓
  • Codex or Claude Code on the bigger screen? On iPad you can run both in one container. FAQ on agent choice ↓

Why is "Codex on iPad" so confusing?

"Codex on iPad" is confusing because OpenAI now ships four different things under the Codex name, and only one of them is a tool you run yourself. As of 2026-06-02 the name covers: the open-source Codex CLI (npm install -g @openai/codex, macOS/Linux/Windows), the desktop Codex App, Codex Web at chatgpt.com/codex, and the Codex feature in the ChatGPT mobile app that launched 2026-05-14. The ChatGPT-app feature is the one most people mean when they say "Codex on my iPad," and it is the one that does the least on the tablet itself.

Here is the opinion that the "just use the ChatGPT app" crowd would push back on: for real agent work, you want the CLI in a Linux box you control, not a phone screen pointed at a Mac in your apartment. The remote-control feature is genuinely useful if you already keep a Mac awake at home. But it keeps your files, credentials, and environment on that Mac and sends screenshots, diffs, and approval prompts to the iPad. The moment the Mac sleeps or the network drops, the iPad has nothing to talk to. A cloud container removes the home machine from the loop entirely, which is the whole reason we built one.

What are the four ways to run Codex on iPad?

There are four real ways to use Codex from an iPad as of 2026-06-25: a cloud container with Codex CLI pre-installed (Cosyra), Codex Web at chatgpt.com/codex in Safari, the ChatGPT app remote-controlling Codex on your Mac, and SSH from Blink Shell into your own always-on machine running Codex CLI. They are not interchangeable. We walk through each below.

1. Cosyra (cloud terminal, Codex CLI pre-installed)

This is what we build. The Cosyra iOS app is a universal binary that runs on iPad with the full iPadOS UI — multitasking, Slide Over, Split View, Stage Manager, external display. You get a persistent Ubuntu 24.04 container with Codex CLI, Claude Code, OpenCode, and Gemini CLI already installed, 30 GB storage, and session hibernation that resumes exactly where you left off. No Mac to keep awake, no SSH tunnel to maintain. The same container is reachable from iPhone, Android, or web, so you can start a Codex session on the iPad and pick it up on a phone in a waiting room.

2. Codex Web at chatgpt.com/codex in Safari

OpenAI's Codex Web is the cloud-agent surface with no install. You connect a repository in the browser and the cloud agent works on it. On iPad it renders in Safari and the larger screen is comfortable for reviewing what the agent did. It is the right pick when you want OpenAI's managed cloud surface and do not need a general-purpose terminal.

3. ChatGPT app, remote-controlling Codex on your Mac

The feature most people picture. On 2026-05-14 OpenAI added Codex to the ChatGPT mobile app on iOS and Android, including iPad. It does not run Codex on the iPad; it remote-controls the Codex App running on your Mac. You scan a QR code the Mac app shows, and from then on the phone or iPad streams screenshots, terminal output, diffs, and approval prompts while the Mac does the work. Per OpenAI's own description, "from your phone, you can work across all of your threads, review outputs, approve commands, change models, or start something new." It is available on all plans, including Free.

4. SSH from Blink Shell to your own machine

The classic remote-into-your-own-box path. Blink Shell is a paid iOS terminal ($19.99 annual subscription as of 2026-06-25 per the App Store listing) with Mosh and tmux support refined over years. You SSH into a desktop or VPS running Codex CLI, run tmux so the session survives app switching, and drive codex from there.

How do you set up Codex CLI on iPad with Cosyra?

You set up Codex CLI on iPad in about three minutes: install Cosyra from the App Store, pair a Magic Keyboard (optional but recommended), add an OpenAI key or sign in with ChatGPT, and type codex. No npm install, no SSH tunnel, no Mac. The steps below are exactly what we run on a fresh iPad.

Step 1: Install Cosyra on iPad

Open the App Store on your iPad and search for Cosyra. The app is a universal iOS binary, so the same listing covers iPhone, iPad Pro, iPad Air, and iPad mini. Sign in with Apple, Google, or email and the app provisions a fresh Ubuntu 24.04 container on first launch, with Codex CLI already on the PATH. The first launch takes about 15 seconds in our testing.

Step 2: Pair a Magic Keyboard and arrange Split View

Attach the Magic Keyboard or any Bluetooth keyboard with a trackpad. The trackpad is the part that matters: it gives you a cursor for text selection, link tapping, and scrollback that the on-screen interface cannot. Then pull a second app in as Split View — we usually keep Safari on the right with the GitHub repo open, and Cosyra on the left with the terminal. On M-series iPads (any M1/M2/M3/M4 iPad Pro or iPad Air from 2022 onward) you can switch to Stage Manager for floating, resizable windows and a second display over USB-C.

Step 3: Add your OpenAI API key and run codex

Codex CLI authenticates either with Sign in with ChatGPT or an OpenAI API key. The key path is the most predictable inside a container. Get a key from the API keys page at platform.openai.com, then in the Cosyra terminal:

cosyra on iPad, adding the OpenAI API key

$ # Set the key (persists across sessions)

$ echo 'export OPENAI_API_KEY="sk-your-key-here"' >> ~/.bashrc

$ source ~/.bashrc

 

$ codex --version

codex-cli 0.136.0

Clone a repo and start a session:

cosyra on iPad, starting Codex CLI

$ git clone https://github.com/your-org/your-project.git

Cloning into 'your-project'...

$ cd your-project

$ codex

OpenAI Codex (0.136.0)

Working in your-project. Type a task to begin.

 

> Add a /health endpoint, wire it into the router, and write a test.

Codex reads the repo and starts working. One thing to know coming from Claude Code: Codex defaults to looser permissions and will run shell commands and package installs inside the workspace without asking each time. For a higher-trust session, start it with codex --ask-for-approval always. On iPad, the larger screen means you can read the full diff without scrolling, which is the single biggest ergonomic win over the phone.

Try it free. 1 hour on signup, no credit card. Extend with a 10-hour, 7-day trial when you want more. App Store / Google Play / Pricing details

Which iPad keyboard shortcuts matter for Codex?

The iPad shortcuts that matter for Codex are the iPadOS multitasking ones, not in-app ones. Cosyra is a normal terminal — Ctrl-C, Ctrl-D, and Cmd-K (clear) all work once a hardware keyboard is attached. The system-level ones worth memorizing:

What does iPad Codex look like in practice?

iPad Codex in practice looks like Cosyra on the left with the terminal, Safari on the right with the repo or docs, and short typed or spoken tasks driving the agent. Two workflows we run from iPad regularly:

Couch feature work with Split View

Evening on the couch, you want a small endpoint added before tomorrow. Open Cosyra, clone or pull the branch, drag Safari in with the repo, and hand Codex the task:

cosyra on iPad, a Codex task

$ git checkout -b feature/health-endpoint

$ codex

 

> Add GET /health returning {status:'ok'}, register the route,

and add a passing test. Then run the test suite.

Codex writes the handler, wires the route, adds the test, and runs the suite. Because its default mode runs commands without prompting, the test run happens on its own; you read the result and commit with git commit from the same terminal. No laptop in the loop.

Two agents, one container, on an external display

Plug an M-series iPad Pro into a USB-C display and enable Stage Manager. Run Codex on a backend task in one Cosyra window and Claude Code on the tests in a second, with Safari showing the staging environment. Because both agents live in the same Ubuntu container, they see the same files and the same git history; you are not syncing anything between them. The iPad is the workstation; the container is the source of truth.

How do the iPad Codex options compare?

The options compare cleanly when you line them up against what matters for an agent: does Codex CLI actually run, does it need a machine of your own, and what happens when that machine sleeps. The table covers the four real iPad paths as of 2026-06-25. For the wider field of editors and cloud terminals beyond Codex, our coding on iPad guide lines every option up the same way.

Feature Cosyra (iPad app) Codex Web (Safari) ChatGPT app remote SSH via Blink
Codex CLI actually runs Yes (in container) Cloud agent, not CLI On your Mac On your host
Native iPadOS app Yes Safari only ChatGPT app Yes (Blink)
Persistent Ubuntu container Yes (30 GB) Managed cloud Your Mac Depends on host
Codex pre-installed Yes Managed You install on Mac You install on host
Requires another machine No No Yes (a Mac) Yes (always-on)
Other CLIs alongside Claude, OpenCode, Gemini No Whatever is on the Mac Whatever is on the host
Split View / Stage Manager Yes Yes (Safari) Yes Yes (Blink)
Setup time ~3 min ~2 min ~5 min (+ a Mac) 15–30 min
Cost on iPad $29.99/mo after trial ChatGPT plan Free + a Mac $19.99/yr + host

Choose Cosyra if you want Codex CLI genuinely running with no machine of your own and the same container across iPad, iPhone, and Android. Choose Codex Web if you want the managed cloud agent and nothing to install. Choose the ChatGPT app remote if you already keep a Mac awake. Choose Blink plus SSH if you want full control of your own host.

Frequently asked questions

Can you actually run Codex CLI on an iPad?

Not locally. Codex CLI is OpenAI's open-source command-line agent that installs on macOS, Linux, and Windows via npm. iPadOS is not a supported host platform and does not run npm globals, so you run Codex CLI through a cloud Linux container the iPad connects to (Cosyra pre-installs it), through Codex Web in Safari, or by SSH from Blink Shell into your own machine.

Is the ChatGPT app's Codex feature the same as running Codex on iPad?

No, and this is the most common confusion. On 2026-05-14 OpenAI added a Codex feature to the ChatGPT mobile app that remote-controls Codex running on your Mac. It works on iPad, but the work runs on the Mac at home; the iPad streams screenshots, diffs, and approval prompts. It is not Codex CLI executing on the tablet.

Do I need a Mac for the ChatGPT app's Codex on iPad?

Not anymore. As of 2026-06-26 the host can be a Mac or a Windows PC — OpenAI shipped Windows host support on 2026-05-29 after launching Mac-only on 2026-05-14. You pair by scanning a QR code the Codex desktop app shows. There is still no Linux mobile-host path, so if you do not have a Mac or Windows machine to host, a cloud container like Cosyra is the path that needs no machine of your own.

Does Codex CLI cost money to run on iPad?

Codex CLI itself is open source under Apache 2.0, so the software is free. You pay for model usage: through a ChatGPT plan with Sign in with ChatGPT, or per-token with an OpenAI API key. On Cosyra you also pay for the container that runs it, $29.99/month after the free tier; OpenAI bills you directly for tokens either way.

Should I run Codex or Claude Code on my iPad?

Run whichever matches your billing and approval taste. Codex defaults to looser permissions and ships fast (0.136.0 as of 2026-06-02); Claude Code stops for approval on most shell commands. On iPad you do not have to choose: a Cosyra container pre-installs both, plus OpenCode and Gemini CLI. Our Claude Code vs Codex CLI comparison goes command by command.

Can I run Codex on iPad without a laptop at all?

Yes. A cloud Ubuntu container is what makes that possible. Cosyra runs the container on Azure and the iPad is just the screen and keyboard, so there is no Mac or PC to keep awake. We start a Codex session on an iPad on the couch and resume the same container on an iPhone later without re-cloning or re-authing.

tl;dr

Codex CLI does not run on iPadOS directly. Four real ways to use it from an iPad as of 2026-06-26: Cosyra (cloud terminal, native iPadOS app, Codex CLI pre-installed, no other machine required), Codex Web at chatgpt.com/codex in Safari (managed cloud agent), the ChatGPT app remote-controlling Codex on your Mac or Windows PC (host supports macOS and Windows as of 2026-06-26, no Linux), or SSH from Blink Shell into your own box ($19.99/yr plus host). Want the CLI actually running with nothing of your own to babysit? Use Cosyra.

App Store / Google Play. Sign up — 1 hour free, no credit card. Extend with a 10-hour, 7-day trial when you want more.

Run Codex CLI on your iPad in 3 minutes. Install Cosyra, add an OpenAI API key, type codex.

See pricing