Shellton Support

Quick answers

“What do I need for agent conversations?”

The remote SSH host needs Node.js 22 or newer and npm. You do not install a Shellton daemon or a generic ACP service: choose Claude Code or Codex in Shellton, and Shellton launches the matching ACP adapter on demand over SSH. Complete the provider’s authentication prompt when asked.

Shellton currently uses @agentclientprotocol/claude-agent-acp for Claude Code and @agentclientprotocol/codex-acp for Codex. If a host is marked “needs Node 22+,” update Node.js and confirm that both node --version and npm --version work in a non-interactive SSH shell.

“My SSH session dies when I switch apps.”

By default, Shellton uses Mosh when available. Mosh survives backgrounding natively over UDP — your session stays alive. If your server doesn’t have mosh-server installed, Shellton falls back to SSH, and SSH sessions do disconnect when iOS suspends the app.

Install mosh-server on the remote host (apt install mosh, brew install mosh, or your platform’s equivalent). Shellton will auto-detect it on the next connection. When Mosh is unavailable, Shellton parks SSH while backgrounded and reconnects on foreground; using tmux keeps the remote work alive across that reconnect.

“How do I add my SSH key?”

Settings → Security → SSH Keys → + button.

  • Generate — create a new Ed25519 key inside Shellton’s Keychain entry.
  • Import — paste an existing private key (OpenSSH or PEM format).

Keys are stored in the iOS Keychain. You can optionally require Face ID / Touch ID before every use.

“How do I move my config between devices?”

Settings → Portability → Export to Clipboard copies a complete YAML config (connections + accessory bar) to the clipboard. On another device, open Settings → Portability → Import from YAML and either paste the clipboard, or pick a .yaml file from Files.app (iCloud Drive, Dropbox, Working Copy — anywhere you keep documents). The same YAML schema is documented in the repo at docs/yaml-schema.md so you can also author or edit it by hand on a Mac.

“Can I use my own terminal theme?”

Yes. Settings → Appearance → Theme → + to create a new one. Or import a theme from the Ghostty theme gallery (paste the config and Shellton will parse it).

“Does Shellton send any data anywhere?”

Shellton sends anonymous product-interaction analytics through TelemetryDeck unless you disable them under Settings → Diagnostics & Privacy. Events are not linked to identity and exclude hostnames, addresses, usernames, commands, terminal text, credentials, voice content, and raw errors. Shellton does not use advertising or cross-app tracking. It also connects to configured SSH/Mosh hosts and, when you use the corresponding options, Apple iCloud, speech-model providers, APNs, and an HTTPS Live Activity webhook you configure. See the privacy policy for the exact fields and purposes.

Contact

For anything not covered above:

When reporting a bug, please include:

  • Shellton version (Settings → About)
  • iOS version
  • A short description of what happened and what you expected
  • Whether the session was SSH or Mosh (if relevant)

Back to home · Privacy