Tutorial

Getting started with TermAI: a visual walkthrough (2026)

A step-by-step, screenshot-by-screenshot guide to TermAI: create an account, add your first SSH connection, ask the AI assistant, save snippets, and reach private servers over Tailscale — in about five minutes.

CC Chen Chen· Founder·July 1, 2026·6 min read

What you'll do

This is a visual walkthrough of TermAI from install to a working SSH session with AI help — about five minutes end to end. You'll create an account, add your first server, ask the AI assistant for a command and run it, save a snippet, and (optionally) reach a private server over Tailscale. Every step has a screenshot so you know exactly what to tap.

TermAI is free to start (5 AI requests a day, unlimited SSH), on both iOS and Android. You don't need a desktop.

Step 1 — Create your account

Open the app and create an account with your email, or sign in with a one-time code. You can make your first SSH connection without any subscription — the account just syncs your hosts and settings and unlocks the AI assistant's free tier.

TermAI create-account screen with email and password fields
Create an account with email, or use a one-time code. The free tier includes the AI assistant and unlimited SSH.

Step 2 — Add your first SSH connection

This is the core of the app. Open the SSH tab. On a fresh install it's empty — tap Add Connection to create your first host.

Empty SSH tab in TermAI with an Add Connection button
The SSH tab starts empty. Tap Add Connection to add your first server.

Fill in the connection details: a label (any name you like), the host (IP or hostname), the port (22 unless you changed it), and your username (often root, ubuntu, or pi). Use the Password / Key toggle to pick how you sign in — password is fastest to start; an SSH key is more secure and recommended for regular use. Keys stay in the phone's secure keystore.

New SSH connection form in TermAI with host, port, username, and password fields
Enter the host, port, username, and choose password or key auth. The private key never leaves the device keystore.

Tap to connect. On the first connection you'll confirm the server's host key (this is normal — it pins the server's identity so you'd be warned if it ever changes). Then you're at a real shell prompt. The row of Esc / Tab / Ctrl / arrow keys above the keyboard makes the terminal usable one-handed — that's how you send Ctrl+C, tab-complete, or edit a file in vim.

A live SSH session in TermAI with the special-keys row above the keyboard
A live session with the Esc/Tab/Ctrl/arrow key row. The connection survives backgrounding and auto-reconnects if the network drops.

Step 3 — Ask the AI assistant

Tap the AI tab (or the sparkle icon in a terminal). Describe what you want in plain English — "how do I set up SSH keys?", "why is my disk full?", "write a command to find the 10 biggest files". The assistant answers with the exact command, explains it, and stays grounded in the server you're connected to.

TermAI AI assistant answering a question about setting up SSH keys with step-by-step commands
Ask in plain language; get the command plus an explanation. The assistant knows which server you're on.

When a suggested command looks right, tap Run to drop it straight into the terminal. Anything destructive (like rm -rf) asks for an extra confirmation first, so the AI can help without surprises.

Running an AI-suggested command directly in the TermAI terminal
Tap Run to send an AI-suggested command to the terminal. Destructive commands require an extra confirmation.

Step 4 — Save command snippets

Commands you run often — restarting a service, tailing a log, checking disk — can be saved as snippets and reused with a tap instead of retyping them on a phone keyboard. Organize them by category and copy or run them from the Snippets tab.

The Snippets list in TermAI with saved reusable commands
Save frequently-used commands as snippets and run them with a tap — no retyping on a phone keyboard.

Step 5 — Reach private servers with Tailscale (optional)

Home-lab boxes and work servers usually aren't on the public internet. TermAI has Tailscale built in, so you can reach them without a separate VPN app or port forwarding. Paste your auth key once, and your private devices show up as connectable hosts.

Tailscale configuration screen inside TermAI showing connected devices
Built-in Tailscale: add your auth key once to reach private, non-public servers directly. More in our Tailscale SSH guide.

Full details in Tailscale SSH on mobile (or Tailscale on iOS for the iPhone setup).

Step 6 — Safety rails with ShellMon

ShellMon watches your session for risky prompts and dangerous commands — it can auto-answer safe confirmations, warn before something destructive runs, and even ask the AI to judge a borderline command. It's a safety net for running real commands on real servers from a phone.

ShellMon settings in TermAI for detecting dangerous commands
ShellMon flags dangerous commands and can auto-handle safe prompts — a guard rail for one-handed sysadmin work.

Plans

The free tier is enough to connect and try the AI (5 AI requests a day, unlimited SSH). Pro ($2.99/mo) lifts the AI limits and unlocks the stronger models plus cloud sync; Team adds more for small groups. You can do everything in this guide on the free tier first.

TermAI free plan screen showing daily AI quota and features
Start free. Upgrade to Pro for higher AI limits, stronger models, and cloud sync when you're ready.

FAQ

Do I need a computer to use TermAI?
No. Everything — adding servers, connecting, keys, AI, file transfer — happens on your phone.

Is it free?
Yes, to start: unlimited SSH and 5 AI requests a day on the free tier. Pro raises the AI limits and adds stronger models and cloud sync.

Where are my passwords and keys stored?
Secrets live in the device's secure keystore. With cloud sync on (Pro), connection metadata syncs encrypted so you can restore on a new device.

Can I reach a server that isn't on the public internet?
Yes — use the built-in Tailscale (Step 5) to reach private home-lab or work servers without port forwarding.

Quick Facts

  • Topic: getting started with TermAI (visual walkthrough)
  • Time to first connection: ~5 minutes
  • Platforms: iOS and Android; no desktop required
  • Free tier: unlimited SSH + 5 AI requests/day
  • Core flow: create account → add SSH host → ask AI → run command
  • Private servers: built-in Tailscale, no separate VPN app
Try TermAI

Free on iOS and Android. 5 AI requests/day on the free tier, plus unlimited SSH/SFTP and built-in Tailscale.

CC
Chen Chen — Founder of TermAI

Writes about mobile DevOps, terminal UX, and the surprising depth of "boring" infrastructure.

Was this useful? ← Back to blog