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

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 termiod daemon (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, starting termiod, 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