The Terminal-first Agentic Development Environment
Download for macOS • Website • Docs • Changelog • Discord
What it is Terminal-first ADE
When agents write most of the code, the environment's job is to run them and to tell you which one needs you. Termio is that environment, and it's a real terminal because that's where the agents already live.
It wires up each agent's own hooks on first launch. A session reports working, idle, or needs you — a dot in the sidebar, a menu-bar tray that rings when one is blocked, the same signal on your phone. Claude Code, Codex, OpenCode, Pi, Amp, Cursor, Copilot, Kimi, Antigravity, Crush, Grok, and any other CLI agent.
A tmux alternative
Many people tell you to learn tmux. You don't have to. Every session's shell lives in termiod, a daemon, so quitting the app only detaches. Close the laptop, reopen Termio — the agent is where you left it, same process, same scrollback. Only Close Session (⌘W) ends one.
Remote ADE
Any Linux VPS you can ssh to. Termio reads ~/.ssh/config and never rewrites it. Settings ▸ Devices ▸ Set Up copies one binary into ~/.local/bin over SSH, starts the daemon, and installs the agents' hooks there. Local and remote sessions run through the same host. The session lives on the box, not in the connection. Drop the link and the agent keeps working; reattach restores the exact screen.
Install
Download Termio for macOS — free, no account, macOS 14+. Or with Homebrew:
brew install --cask termio-sh/tap/termio
On iPhone: get the companion beta on TestFlight, then pair it by scanning the QR code in the Mac app's Settings ▸ Mobile.
What you get
Drive it from the terminal
The termio CLI drives the running app. An agent inside Termio can spawn a sibling, hand it a task, and read back the reply:
termio . # open the current directory as a project
termio sessions list # who's working, idle, or waiting on you
termio sessions spawn "fix the flaky test" # start a new agent session on a prompt
termio sessions run "pnpm test --watch" # start a plain terminal session on a command
termio sessions send ab12cd34 "1" # answer a sibling's permission prompt
termio sessions read ab12cd34 --lines 40 # print what's on a session's screen
termio sessions watch # stream status changes as they happen
termio sessions focus ab12cd34 # bring a session forward in the app
termio sessions close ab12cd34 # close it
termio notify "the migration finished" # post a macOS notification
--wait blocks until the turn settles and comes back with the final status and the transcript range to read. --json makes any sessions command machine-readable. --agent picks which agent spawn starts. --direction / --ratio decide where the new pane lands and how big it is.
termio sessions spawn "run the migration" --agent codex --wait
Session control installs a termio agent skill into each agent's skills folder (~/.claude/skills, ~/.codex/skills) and keeps it current on every launch. Any other agent can install the same skill from this repo:
npx skills add termio-sh/termio --skill termio
On your iPhone
The Termio iOS mirrors every session live — full TUI. A key bar puts esc, tab, ctrl, and arrows above the keyboard, and hold-to-speak transcribes into the prompt. Public beta on TestFlight.
Architecture
Every session lives in termiod. Clients only attach. Closing a client does not kill the agent. One protocol; only the pipe changes.
┌─────────────────┐ unix ┌────────────┐ ┌─────────────────┐
│ Mac app │──────►│ │ │ │
├─────────────────┤ unix │ │ │ │
│ Windows (soon) │──────►│ │ │ │
├─────────────────┤ wss │ │ │ │
│ iPhone │──────►│ termiod │── PTY ─►│ shell / agent │
├─────────────────┤ unix │ (Mac) │ │ │
│ TUI (soon) │──────►│ │ │ │
├─────────────────┤ wss │ │ │ │
│ Android (soon) │──────►│ │ │ │
└─────────────────┘ └────────────┘ └─────────────────┘
┌─────────────────┐ ssh ┌────────────┐ ┌─────────────────┐
│ Mac app │──────►│ │ │ │
├─────────────────┤ ssh │ │ │ │
│ Windows (soon) │──────►│ │ │ │
├─────────────────┤ wss │ │ │ │
│ iPhone │──────►│ termiod │── PTY ─►│ shell / agent │
├─────────────────┤ ssh │ (Linux) │ │ │
│ TUI (soon) │──────►│ │ │ │
├─────────────────┤ wss │ │ │ │
│ Android (soon) │──────►│ │ │ │
└─────────────────┘ └────────────┘ └─────────────────┘
The phone attaches to termiod on the box, not through the Mac. A session on a VPS is the same object as one on your laptop.
The reasoning is in termiod/ARCHITECTURE.md.
Roadmap
- TUI client — attach from any terminal, the way you would to tmux.
- TUI → GUI on mobile — an optional GUI rendering of agent sessions on the phone, built on top of the live mirror.