Shell22
DE
Notify me
Menu

Shell22 / Support

Support

Email hello@shell22.de. The quickest way to help us is to include a support report from the app: Settings → Help & Support → Bug Report. You can review it before sending.

Codex doesn’t scroll smoothly

Codex uses full-screen mode by default and handles scrolling with mouse-wheel signals. With this option, the transcript stays in the terminal and scrolls like a web page:

codex --no-alt-screen

To make this permanent, in ~/.codex/config.toml:

[tui]
alternate_screen = "never"

Get notified when Codex or Claude is waiting

Enable notifications in Settings → Notifications in the app (Pro). Then configure your server:

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

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

In tmux, usually only the bell signal gets through: use notification_method = "bel" for Codex and terminal_bell for Claude Code. Background notifications only arrive while “Keep Connection in Background” is enabled.

Merge the Claude entry into the existing JSON file and keep other settings. For Codex inside tmux choose notification_method = "bel". A bell signal has no program message. The app can hide message text; iOS controls the Lock Screen preview.

Sign in with an SSH key instead of a password

Settings → SSH Keys → “Generate New Key”. Copy the command on the detail page and run it on your server once, then choose “SSH Key” in the host editor.

Resume a Codex or Claude session

Open Snippets → + → Codex and Claude templates. codex agents and claude agents open overviews. codex resume --all selects an available conversation; claude attach SESSION_ID opens a background agent. Connect to the correct computer, user and agent server. Not every running desktop window is accessible from the CLI.

Explain commands locally

The Apple Intelligence symbol in the session bar briefly explains entered or selected commands. Explanations stay on your device and run nothing. They can contain errors and require a supported device with Apple Intelligence enabled and available.

Change the font and text color

Settings → Theme and Font offers SF Mono, Menlo, Courier, font size and text color with a live preview. Theme Color resets a custom color. These choices apply to all terminals on this device.

What does iCloud sync?

If you are signed in to iCloud and have not disabled iCloud for Shell22, the app syncs servers, groups, snippets, workflows and public key data through your private CloudKit database. This also includes the latest workflow run status and up to 128 KB of output per workflow. This data is stored in your iCloud account with Apple; we do not operate a sync server. You can disable syncing in iOS Settings under your name → iCloud. Passwords, private SSH keys and trusted host keys remain in the device-bound Keychain and are not synced. Settings → iCloud shows confirmed transfers and possible issues. Each device needs its own private keys or passwords.

Pro on a new device

Pro is a one-time purchase tied to your Apple ID. On a new device, tap “Restore Purchases” in the paywall.

GOOD TO KNOW

One more question?

What does Shell22 cost?

Shell22 is free. Pro unlocks more features for a one-time payment of €14.99. No subscription. This is the price in Germany; other regions follow Apple’s pricing tiers.

Do I need an account?

No account or registration. Your SSH connection goes directly from your device to your server.

Does Shell22 work on iPad?

Yes. Shell22 supports iPhone and iPad running iOS or iPadOS 27.0 or later.

Does Shell22 work with Claude Code and Codex?

Yes. The agents run on your server. Shell22 is your SSH terminal, with per-host start commands, tmux and optional notifications with Pro.

Does my session survive a dropped connection?

With tmux enabled for the host, reconnecting reattaches to the same session. tmux must be installed on your server; the app does not install it.

Where are passwords and key data stored?

Passwords, private keys and trusted server identities stay in the device-bound Keychain. Public key data, servers and snippets sync when iCloud is enabled. Workflows also include the latest run and up to 128 KB of output.

Which authentication methods are supported?

Passwords, Ed25519 and ECDSA. Supported devices can create P-256 keys in the Secure Enclave. Import Ed25519 and ECDSA keys, including passphrase-protected OpenSSH files; RSA is not supported.

How do I use Pro on a new device?

Tap “Restore Purchases” in the paywall. Your purchase is tied to your Apple ID.

Does the app collect data?

No. Shell22 has no analytics, ads or tracking. See the privacy policy for details.