termio
A terminal-first agentic development environment for agentic coding. Build for CLI/TUI agent. Runtime for Coding Agent, Tmux alternative
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/termio-sh/termio with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/termio-sh/termio'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/termio-sh--termio)HTML
<a href="/listings/termio-sh--termio"><img src="/api/listings/termio-sh--termio/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
**[Download Termio for macOS](https://downloads.termio.sh/termio.dmg)** — free, no account, macOS 14+. Or with [Homebrew](https://brew.sh):
brew install --cask termio-sh/tap/termio
**On iPhone**: get the companion beta on [TestFlight](https://testflight.apple.com/join/1Arf1UKR), then pair it by scanning the QR code in the Mac app's Settings ▸ Mobile.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 204 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- <div align="center">
- <img alt="Termio" src="web/landing/public/logo.png" width="88" />
- ### The Terminal-first Agentic Development Environment
- [](https://github.com/termio-sh/termio/releases)
- [](LICENSE)
- [](https://discord.gg/H9DKVwsE5f)
- <p>English | <a href="README.zh-CN.md">简体中文</a> | <a href="README.zh-TW.md">繁體中文</a> | <a href="README.ja.md">日本語</a> | <a href="README.ko.md">한국어</a></p>
- [**Download for macOS**](https://downloads.termio.sh/termio.dmg) • [Website](https://termio.sh) • [Docs](https://termio.sh/docs) • [Changelog](https://termio.sh/changelog) • [Discord](https://discord.gg/H9DKVwsE5f)
- <img alt="Codex and Claude Code with a development server in Atom One Dark" src="web/landing/public/screenshots/hero1.png" width="100%" />
- </div>
- ## 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](https://downloads.termio.sh/termio.dmg)** — free,
- no account, macOS 14+. Or with [Homebrew](https://brew.sh):
- ```sh
- brew install --cask termio-sh/tap/termio
- ```
- **On iPhone**: get the companion beta on
- [TestFlight](https://testflight.apple.com/join/1Arf1UKR), then pair it by
- scanning the QR code in the Mac app's Settings ▸ Mobile.
- ## What you get
- <table>
- <tr>
- <td width="62%"><img alt="Project sessions and worktrees in the Termio sidebar" src="web/landing/public/screenshots/docs/04-project-session-hierarchy.png" width="100%" /></td>
- <td width="38%" valign="top">
- <h3>Projects hold sessions</h3>
- <p>One project per checkout, its terminals and agents underneath. Chats sit above that — scratch agent sessions that don't belong to any project.</p>
- </td>
- </tr>
- <tr>
- <td width="62%"><img alt="A selected worktree beside grouped agent sessions" src="web/landing/public/screenshots/docs/12-worktree-hierarchy.png" width="100%" /></td>
- <td width="38%" valign="top">
- <h3>Git worktrees</h3>
- <p>One branch per parallel task, created from the sidebar. Worktrees nest under the project they came from.</p>
- </td>
- </tr>
- <tr>
- <td width="62%"><img alt="Codex and Claude Code above a development server" src="web/landing/public/screenshots/docs/03-grouped-panes.png" width="100%" /></td>
- <td width="38%" valign="top">
- <h3>Split panes</h3>
- <p>⌘D splits right, ⇧⌘D splits down. An agent, a dev server, and a shell in one window.</p>
- </td>
- </tr>
- <tr>
- <td width="62%"><img alt="Horizontal tabs above Claude Code, Codex, and two terminals" src="web/landing/public/screenshots/docs/29-horizontal-tabs.png" width="100%" /></td>
- <td width="38%" valign="top">
- <h3>Horizontal tabs</h3>
- <p>Sessions in one row above the terminal. Click a tab to switch, drag it to reorder. Turn it on in Settings ▸ Appearance ▸ Tabs. <a href="https://github.com/termio-sh/launch-video/tree/main/20261019-horizontal-tabs">Watch the video</a>.</p>
- </td>
- </tr>
- <tr>
- <td width="62%"><img alt="Project session types and live states beside Codex and Claude Code" src="web/landing/public/screenshots/docs/05-session-statuses.png" width="100%" /></td>
- <td width="38%" valign="top">
- <h3>Status at a glance</h3>
- <p>Working, idle, done, or <em>needs you</em> — a mark on every row. The same list is <code>termio session list</code>.</p>
- </td>
- </tr>
- <tr>
- <td width="62%"><img alt="SplitTree.swift in the editor beside Claude Code" src="web/landing/public/screenshots/docs/06-files-editor.png" width="100%" /></td>
- <td width="38%" valign="top">
- <h3>File editor</h3>
- <p>Click a file in the tree. Syntax highlighting, autosave. The terminal stays the place where you commit.</p>
- </td>
- </tr>
- <tr>
- <td width="62%"><img alt="A unified diff beside Claude Code" src="web/landing/public/screenshots/docs/07-changes-diff.png" width="100%" /></td>
- <td width="38%" valign="top">
- <h3>Changes</h3>
- <p>A read-only git pane with the current unified diff. Commit, push, and PR stay in the terminal.</p>
- </td>
- </tr>
- <tr>
- <td width="62%"><img alt="SplitBranch search results grouped by file" src="web/landing/public/screenshots/docs/09-project-search.png" width="100%" /></td>
- <td width="38%" valign="top">
- <h3>Search</h3>
- <p>Project-wide content search, jumping to the matching line in the editor.</p>
- </td>
- </tr>
- <tr>
- <td width="62%"><img alt="Session and split commands in the Command Palette" src="web/landing/public/screenshots/docs/10-command-palette.png" width="100%" /></td>
- <td width="38%" valign="top">
- <h3>Command palette</h3>
- <p>⌘⇧P. Split, focus, anything you'd hunt a menu for.</p>
- </td>
- </tr>
- </table>
- ## 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:
- ```sh
- termio . # open the current directory as a project
- termio session list # who's working, idle, or waiting on you
- termio session spawn "fix the flaky test" # start a new agent session on a prompt
- termio session run "pnpm test --watch" # start a plain terminal session on a command
- termio session send ab12cd34 "1" # answer a sibling's permission prompt
- termio session read ab12cd34 --lines 40 # print what's on a session's screen
- termio session watch # stream status changes as they happen
- termio session focus ab12cd34 # bring a session forward in the app
- termio session 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.
- ```sh
- termio session spawn "run the migration" --agent codex --wait
- ```
- Session control installs a `termio` [agent skill](https://termio.sh/skill.md) 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:
- ```sh
- 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](https://testflight.apple.com/join/1Arf1UKR).
- <table>
- <tr>
- <td><img alt="Termio on iPhone: the home screen, with Needs You above the projects" src="web/landing/public/screenshots/iphone-home.webp" width="230" /></td>
- <td><img alt="Termio on iPhone: the sessions in a project, each reporting its status" src="web/landing/public/screenshots/iphone-sessions.webp" width="230" /></td>
- <td><img alt="Termio on iPhone: a live agent session with the key bar above the keyboard" src="web/landing/public/screenshots/iphone-session-keys.webp" width="230" /></td>
- </tr>
- </table>
- ## Architecture
- Every session lives in `termiod`. Clients only attach. Closing a client does not kill the agent. One protocol; only the pipe changes.
- ```
- Mac app ─ unix/ssh ─┐
- TUI (soon) ─ unix/ssh ─┤
- ├──► termiod
- iPhone ─ wss ──────┤ │
- Android (soon) ─ wss ──────┘ │ PTY
- ▼
- shell / agent
- ```
- 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`](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.
- - **Android** — the same companion as iPhone.
- - **Windows support** — Termio as a native Windows app. Same idea, same termiod core.
- - **Web support** — attach to your sessions from any browser, with terminals you can share by link.
- - **Issue triage** — GitHub, GitLab, and Linear issues inside the app, ready to hand straight to an agent.
- Follow along or weigh in on [GitHub Issues](https://github.com/termio-sh/termio/issues).
- ## Community
- **Termio is looking for long-term maintainers.** If you love using it and would like to own an area of the roadmap above — the web client, Windows, or the iOS companion — join the Discord and say hi, or just pick up an issue.
- - **[Discord](https://discord.gg/H9DKVwsE5f)** — chat with the developer and other users
- - **WeChat group** — Chinese-speaking users, scan the QR code below
- - **[GitHub Issues](https://github.com/termio-sh/termio/issues)** — bugs and feature requests
- <img alt="WeChat group QR code" src="web/landing/public/wechat-group.png" width="220" />
- The WeChat code expires every few days. If it has, ask in Discord and it gets refreshed.
- ## Contributors
- <a href="https://github.com/termio-sh/termio/graphs/contributors">
- <img src="https://contrib.rocks/image?repo=termio-sh/termio" alt="Contributors" />
- </a>
- ## License
- [MIT](LICENSE).
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.