Support

What is TerminaLLM?

TerminaLLM is a mobile SSH terminal client built specifically for running AI coding assistants like Claude Code, Aider, and other CLI tools from your phone. It includes features like session persistence, session sharing, Swarm (a team of AI agents run from your phone), a built-in AI chatbot, and comprehensive security controls.

What's the difference between Free, Plus, and Pro?

Free gives you the full SSH terminal, SFTP browser, AI change detection, voice dictation, security suite, 5 saved connections, all 15 themes plus custom theme editor, and a daily taste of every Plus feature.

Plus ($4.99/mo) removes every Free-tier cap, unlocks unlimited saved connections, and adds multi-hop SSH through jump hosts.

Pro ($9.99/mo) adds Swarm (run a team of AI agents on your server), the AI Assistant Chat, and voice-to-command translation on top of Plus.

What is Swarm?

Swarm (Pro only, new in 1.2) launches a crew of AI coding agents on your own server: a lead architect breaks the job into pieces while the agents you choose work side by side, each in its own live terminal pane you can read, type into, and take over. Swarm works with any terminal AI agent, with one-tap presets for Claude Code, Codex, and Aider, or point any pane at your own command. Swarm needs a small helper daemon on your server, which the app can install for you (one tap on supported servers). Agents run under your own AI CLI logins on your machine; your prompts and code never pass through TerminaLLM's servers.

How does the AI Assistant Chat work?

The AI Assistant Chat (Pro only) lets you ask questions about your terminal session, your code, or how to use TerminaLLM. Messages are sent through our proxy server to Anthropic's Claude API. The first time you use the chatbot, an in-context permission dialog appears explaining what data is sent. You can revoke consent at any time in Settings → Security → "AI features (Anthropic)". Conversation history (last 50 messages) is stored locally in encrypted storage for continuity across sessions.

How does the wand button translate to shell commands?

The wand button (Pro only) takes your natural-language request — typed or spoken — and asks Anthropic's Claude to suggest the equivalent shell command. Only the transcribed text is sent to our proxy; TerminaLLM never transmits audio. If you dictate with the Built-in speech engine, your device's platform speech service may process audio on Apple or Google servers. Choose the Whisper engine in Settings for fully on-device transcription. The wand requires the same in-context consent as the AI Assistant Chat, and you can revoke it from the same Settings toggle.

How do I connect to my server?

Enter your server's hostname, port (default 22), and username on the connection screen. You can authenticate with a password or private key. Save connection profiles for quick reconnection by tapping the "+" button in the Saved Connections section.

What AI coding assistants are supported?

TerminaLLM works with any CLI-based AI coding tool you can run over SSH, including Claude Code, Aider, GitHub Copilot CLI, and others. The terminal is optimized with dedicated modifier keys and AI tool detection for these tools.

How does session persistence work?

TerminaLLM's T-TCP helper (a small binary the app can deploy to your server) keeps your terminal session alive on the remote server even when your phone disconnects. On plain SSH connections without the helper, dtach is used as a fallback. Either way, when you reconnect you pick up right where you left off, and your AI assistant keeps running.

What is session sharing?

Session sharing lets you attach to the same terminal session from a laptop or a second device. On T-TCP sessions (the default when the TerminaLLM helper is installed on your server), the share flow can open a pre-attached terminal window on your desktop or let another TerminaLLM device join the same session, with no dtach involved. On SSH (dtach) sessions, tapping the mirror icon generates an SSH command that attaches via dtach, which must be installed on the remote server.

How do I connect through a jump host / bastion?

If your server is behind a bastion host, save the bastion as a connection profile first. Then on the connect form, use the "Jump Host" dropdown to select it (or tap "+ New jump host..." to create one inline). The app connects to the bastion first, then tunnels through to your target server. Jump host credentials are resolved from the encrypted vault or can be entered inline. This is a Plus feature.

Is my data secure?

Yes. All sensitive data is stored in platform-native encrypted storage (iOS Keychain / Android EncryptedSharedPreferences). SSH connections use standard protocol encryption. The app includes TOTP MFA, biometric authentication, host key verification, and audit logging. See our Privacy Policy for details.

How do I delete my account or data?

TerminaLLM stores nearly all data locally on your device in encrypted storage. The AI chatbot communicates with a proxy server, but no conversation content is logged server-side. Uninstalling the app removes all local data. See our Account Deletion page for detailed instructions.

Connection times out

Verify your server hostname and port are correct. Ensure your server is reachable from your network (some networks block port 22). Try connecting on a different network (e.g., mobile data vs WiFi). Check that your server's SSH daemon is running.

Authentication failed

Double-check your username and password. If using key-based auth, ensure your public key is in the server's ~/.ssh/authorized_keys. If you recently changed your password, clear the saved credential from the Credential Vault.

Terminal rendering looks wrong

Go to Settings > Terminal & Display and try adjusting the font size. Ensure your server's TERM is set to xterm-256color. If specific characters don't render, check that your server has the required font or locale configured.

Browser blocking during AI sessions

When Claude Code or other AI tools try to open a browser (e.g., for OAuth), it can block terminal input. Use the URL action sheet to "Open in Browser" or copy the URL instead of letting the AI tool open it directly. Ctrl+C may not work in this state.