OS·WholeTech
📱 iPhone & iPad

The AI stack on iPhone & iPad.

Here's the honest truth up front: Apple does not let you install command-line tools like Claude Code directly on an iPhone or iPad — there's no Termux-style app that can run them properly. So on iOS the game is different. You do two things: (1) use the official chat apps, and (2) turn your phone into a secure remote into a real computer — a Mac, PC, droplet, or Proxmox box — that has the tools installed.

This guide reframes the six steps around that reality. The good news: once it's set up, you really can code from an iPad on the couch, driving Claude Code on a machine across the house or across the country.

Before you start

What you'll need

1

The apps & an SSH client (your "terminal")

On iOS you can't run the command-line AI tools themselves — Apple doesn't allow it. So your phone plays two roles: a chat client (the official apps) and a remote terminal into a real computer (an SSH client).

Why this first: for many people the chat apps are all they need. And the SSH client is the key that unlocks every "power" step below — it's how your phone reaches a machine that can run the tools.

Install the official chat apps

From the App Store, install Claude, ChatGPT, and Google Gemini. Sign in to each with the matching account. This gives you full chat anywhere — on the train, in line, in bed. For a lot of people, this is the whole stack.

Install an SSH client (your terminal)

For real command-line power, you need an app that can connect into another computer's terminal. Two good choices on the App Store:

  • Blink Shell — excellent, polished, paid.
  • Termius — has a free tier to get started.

Either one lets you log into a Mac, PC, droplet, or Proxmox box and type commands as if you were sitting at it.

✓ Working when: you can open your SSH app and it's ready to add a connection (it shows a "+" or "New Host" screen, waiting for an address to connect to).
2

Claude Code (run it on a remote machine)

Anthropic's AI coding agent — the same kind of assistant that built this page. It reads and edits real files and runs commands. You can't install it on the iPhone, but you can drive it on another computer through your SSH app.

Why you want it: it does actual multi-step work — build a site, fix a script, organize files — not just chat.

Install it on a real computer first

Set up Claude Code on a Mac, PC, droplet, or Proxmox box using those guides. Then, from your SSH app on the phone, connect to that machine and run:

claude

That's it — you're now talking to Claude Code on the remote machine, from your phone, in plain English.

✓ Working when: after connecting over SSH, typing claude drops you into a prompt that greets you.
💡Tip: this is genuinely how people code from an iPad — SSH into a real box over Tailscale (Step 5) and drive Claude Code there. The full Claude playbook lives at claude.wholetech.com.
3

Codex (same idea)

OpenAI's command-line coding agent. Same approach as Claude Code on iOS — it runs on a real computer, and you reach it from your phone over SSH.

Why you want it: variety. Different models are stronger at different things; having both means you're never stuck.

Connect and run

Connect via SSH to a machine that has Codex installed, then run:

codex
✓ Working when: over SSH, codex opens its prompt and responds to what you type.
4

Gemini (two options)

Google's AI. On iOS you have an easy path and a power path — pick whichever fits the moment.

Why you want it: free headroom. Great for big, sprawling tasks before you spend on the others.

Easiest: the app

Use the Google Gemini app from the App Store (you installed it in Step 1). Sign in with your Google account and chat away.

Power: the Gemini CLI over SSH

SSH into a machine that has the Gemini CLI installed, then run:

gemini
✓ Working when: the app answers your questions, or — over SSH — gemini opens its prompt.

Hermes Agent bonus · 4th agent

A coding agent from Nous Research — "the agent that grows with you." Same idea as Claude Code, Codex, and Gemini, with two twists: it's self-improving (it learns your preferences over time), and it's model-agnostic — you point it at whichever brain you want (Nous, OpenAI, Anthropic, OpenRouter, and more). Same approach as Claude Code on iOS: it runs on a real computer, and you reach it from your phone over SSH.

Why you'd add it: it's a fourth tool in the rotation and the most model-flexible of the bunch — handy for staying un-locked-in (see the future-proofing principles).

Install it on a real computer first

You cannot install Hermes on an iPhone or iPad — Apple doesn't allow it. Instead, install it on a Mac, PC, or droplet using those guides. Then, from your SSH app (Blink or Termius, over Tailscale), connect to that machine and run:

hermes --tui
✓ Working when: after connecting over SSH, hermes --tui opens its interface.
💡Same as Claude Code: this is the identical remote approach — SSH into a real box over Tailscale (Step 5) and drive Hermes there. Official docs: hermes-agent.nousresearch.com/docs.
5

Tailscale (the key that makes remote access work)

A private network (a "mesh VPN") that connects all your devices to each other securely — your phone, your Macs, your PCs, your NAS — as if they were in the same room, from anywhere in the world.

Why you want it: this is what makes Steps 2, 3, and 6 actually usable on the go. With Tailscale, your SSH app can reach any of your computers by name — and nothing is exposed to the public internet.

Install & sign in

Install the official Tailscale app from the App Store. Sign in with the same account you used on your other devices — that's what joins them all to one private network.

✓ Working when: the app shows your other machines, each with a 100.x.y.z address and a status of Connected.
🌐Now you're mobile: your SSH app can reach any of your computers by name from anywhere — coffee shop, car, hotel — with no ports exposed to the public internet. If you enabled Tailscale SSH on your Linux box, you can just connect to its name without even managing keys.
6

Ollama (use it, don't host it)

Ollama runs AI models locally — free, private, offline. On iOS the trick is to run it on a real machine and use your phone as a client.

Why you want it: no per-use cost, nothing leaves your control, and one beefy machine at home can answer from your phone anywhere.

Reality check: you cannot run Ollama models on an iPhone or iPad in any practical way. The chips and memory aren't there for it.
The approach
💡How it actually works: run Ollama on a home Mac, PC, or NAS, expose it over Tailscale (Step 5), then use an iOS client app that supports a custom Ollama server URL. A good open-source option on Apple platforms is Enchanted. Point it at your home machine's Tailscale address on port 11434.
✓ Working when: the app returns answers generated by your home machine's model — free and private, from your phone.
You're done

What you have now

Your iPhone or iPad is now a full AI cockpit: the official chat apps in your pocket, and — through an SSH client over Tailscale — a remote control into the real computers that run Claude Code, Codex, Gemini, and Ollama. You didn't fight Apple's limits; you worked around them.