Claude Code and Codex
on iPhone, over SSH.

Set up. Connect. Get to work.

1. Add your server

   Enter the host, username and authentication. The connection goes straight from your device to your server.

2. Set the project and start command

   Choose a start directory and set claude or codex as the start command for your host.

3. Enable tmux

   Reattach to the same session when reconnecting. tmux must already be installed on your server.

Return to a session.

Under Snippets → + → Codex and Claude templates, find agent overviews and commands to resume. Connect to the correct computer and user. Codex shows sessions on the connected agent server; Claude attach opens background agents. Not every desktop window is accessible from the CLI.

codex agents --no-alt-screen
codex resume --all --no-alt-screen
claude agents
claude attach SESSION_ID

Commands, briefly explained.

Apple Intelligence explains entered or selected commands: their purpose, key options and an illustrative example output when useful. Explanations stay on your device and run nothing.

Requires a supported device with Apple Intelligence enabled and available. Model responses can contain errors.

Know when your agent needs you.

With Pro, Shell22 supports bell, OSC 9 and OSC 777. Configure your server as shown here or in Support.

# Codex: ~/.codex/config.toml
[tui]
notifications = true
notification_method = "osc9"

# Claude Code: ~/.claude/settings.json
{
  "preferredNotifChannel": "terminal_bell"
}

Claude Code: merge preferredNotifChannel into the existing ~/.claude/settings.json; do not replace the whole file. For Codex inside tmux, choose notification_method = "bel". A bell signal contains no program message. Background notifications require the SSH connection to remain active.

Send images to your session.

Send up to eight images from Photos, Files or the clipboard. After uploading, the paths are inserted without pressing Return.

Room for longer prompts.

A multi-line prompt editor, dictation and dedicated thumb keys for AI sessions.

Scroll smoothly in Codex.

Without full-screen mode, the transcript stays in the terminal. Scroll on your iPhone just like a web page.

codex --no-alt-screen

# ~/.codex/config.toml
[tui]
alternate_screen = "never"