Support
Need help with TerminaLLM? We're here for you.
Contact Us
Email Support
For general questions, bug reports, or feature requests.
Guides
AI Tool Authentication
Set up authentication tokens for Claude Code, GitHub Copilot, OpenAI Codex, Gemini, and other AI coding tools before connecting via TerminaLLM.
Frequently Asked Questions
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), and comprehensive security controls.
Is TerminaLLM free?
Yes. Starting with version 1.4.0, every feature is free: the full SSH terminal, SFTP browser, AI change detection, voice dictation, Swarm, multi-hop SSH through jump hosts, the full security suite, unlimited saved connections, unlimited SFTP bookmarks, unlimited encrypted backups, unlimited batch SFTP operations, and all 15 themes plus the custom theme editor. Version 1.4.0 has no subscriptions and no in-app purchases. If you subscribed in an earlier version of the app, your subscription is cancelled and refunded through the store you bought it from; if you believe you were not refunded, contact legal@terminallm.app.
What is Swarm?
Swarm 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, Gemini, Cursor, Copilot, Kiro, Amp, and Aider, or point any pane at your own command. Any agent can command its own sub-swarm with Cascade, and any live pane can be read as a chat. 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 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, Codex, Aider, Cursor, Gemini, Amazon Q, Amp, OpenCode, and GitHub Copilot CLI. 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.
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. If you use push notifications, a device identifier and push token are processed by our proxy server; no terminal content or code is ever sent to it. Uninstalling the app removes all local data. See our Account Deletion page for detailed instructions.
Troubleshooting
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.