termio-sh/termio
A terminal-first agentic development environment for agentic coding. Build for CLI/TUI agent. Runtime for Coding Agent, Tmux alternative
Termio – a terminal‑first Agentic Development Environment
What it is
- A macOS application (with iOS companion) that treats each AI‑code‑assistant (Claude, Codex, Cursor, Copilot, etc.) as a session running inside a persistent daemon called
termiod. - The UI is a real terminal‑style workspace (similar to tmux) where you can split panes, view git worktrees, edit files, and see a live diff, all while the agents keep working in the background.
Why it matters
- Agents already live in the command line; Termio keeps them there instead of moving them into a separate IDE.
- Sessions survive app closes, laptop sleep, or network disconnects – the underlying process stays alive in
termiod. - A visual “needs you” indicator tells you when an agent is blocked and requires human input.
Key features
| Feature | What you get |
|---|---|
| Project‑based hierarchy | One project per checkout; sessions and chats are grouped under it. |
| Git worktree support | Create a separate worktree for each parallel branch directly from the sidebar. |
| Split panes | ⌘D (right) / ⇧⌘D (down) to place an agent, dev server, or shell side‑by‑side. |
| Session status | Working, idle, done, or needs you shown as a dot; same list available via termio sessions list. |
| Built‑in file editor | Click a file, get syntax highlighting and autosave while the terminal stays the source of truth. |
| Git diff pane | Read‑only unified diff of current changes; commit/push still done in the terminal. |
| Project‑wide search | Search all files and jump to the matching line in the editor. |
| Command palette | ⌘⇧P for quick actions (split, focus, etc.). |
| CLI control | termio commands to open projects, list/spawn sessions, run commands, send input, watch status, focus/close sessions, and send macOS notifications. |
| Agent skill injection | On launch Termio installs a skill into each supported agent’s skill folder so the agent can be controlled via the CLI. |
| Remote ADE | Attach to any Linux VPS via SSH; the session lives on the remote host, not the connection. |
| iPhone companion | Mirrors every session as a full‑screen TUI; a key bar adds ESC/CTRL keys and voice‑to‑text input. |
Installation
- macOS 14+ download: https://downloads.termio.sh/termio.dmg
- Homebrew:
brew install --cask termio-sh/tap/termio - iPhone beta via TestFlight (link in README).
Typical CLI workflow
termio . # open current folder as a project
termio sessions list # see which sessions are working or waiting
termio sessions spawn "fix flaky test" --agent codex --wait
termio sessions run "pnpm test --watch"
termio sessions send <id> "yes"
termio sessions read <id> --lines 40
termio sessions watch # stream live status changes
The --json flag makes output machine‑readable, and --wait blocks until the agent finishes its turn.
Architecture
- All sessions run inside the
termioddaemon (a PTY process). Clients (Mac app, TUI, iPhone) attach via Unix sockets or WebSocket Secure (wss). Closing a client does not kill the session. - Remote sessions are launched on a VPS by copying a binary to
~/.local/bin, startingtermiod, and installing agent hooks. - The same protocol is used for local, remote, and mobile clients, enabling a uniform view of sessions.
Roadmap (as listed)
- TUI client (terminal‑only attachment, like tmux)
- Optional GUI rendering on mobile
- Android companion
- Native Windows app
- Web client for browser‑based attachment and sharing
- Built‑in issue‑triage integration (GitHub, GitLab, Linear)
Community & contribution
- Open source under the MIT license.
- Actively seeking long‑term maintainers for web, Windows, or iOS components.
- Discord server, WeChat group, and GitHub Issues for support and feature discussion.
Bottom line Termio is a genuine software project aimed at developers who use AI coding assistants. It provides a persistent, terminal‑centric workspace that keeps agents alive, surfaces their status, and lets you manage them from macOS, iOS, or any SSH‑accessible host.
Related
- Project
- Project
- Project
- Project
- Project