or install via Homebrew:
brew tap daniakash/tap && brew install --cask agent-terminal
✅ Stable on macOS + Zsh. Daily-driven, safe to install, and used every day. See the platform matrix below for other shells and operating systems.
If you live in a terminal alongside Claude Code, Codex, or other AI coding agents, you've probably noticed normal terminals weren't designed for the way you work now: multiple agents, multiple projects, multiple long-lived sessions, all needing context at a glance.
Agent Terminal is a terminal that knows the difference between a shell and an agent. It groups your tabs by project, recognises when an agent is running, and surfaces what's happening — the model in use, what's listening on which port, the git branch, your cwd — without you switching windows or running ps.
Group tabs under projects (my-app, notes, infra). Switch projects without losing your place — every tab remembers its working directory and reopens there.
Always-on context for the focused tab — refreshed every couple of seconds, never gets stale:
- Process name, PID, elapsed time, memory
- Listening TCP ports (so you know when your dev server is up)
- Git branch, dirty indicator, ahead/behind remote
- Working directory (hover for full path)
Switch between light, dark, and system themes from the status bar. The chosen theme now applies across the whole application and the active terminal, so agent sessions stay readable in both light and dark modes.
| Agent | Status |
|---|---|
| Claude Code | ✅ Supported |
| Codex CLI | ✅ Supported |
| opencode | ✅ Supported |
| Amp | 🧪 Experimental |
| Kilo Code | 🧪 Experimental |
| Kimi CLI | 🧪 Experimental |
| Mastra | 🧪 Experimental |
| Cursor | 🔜 Planned |
| GitHub Copilot CLI | 🔜 Planned |
| Factory Droid | 🔜 Planned |
| Qoder | 🔜 Planned |
Status key: ✅ Supported = primary, well tested. 🧪 Experimental = detection works, still being tested. 🔜 Planned = coming soon.
Want support for another agent? Open an issue or tell me on X.
Cmd+P opens a switcher for your recently used tabs — type a few letters, hit Enter, you're there.
Ctrl+T— new tab in the active projectCtrl+W— close the active tabCtrl+Tab/Ctrl+Shift+Tab— cycle tabsCtrl+1…Ctrl+9— jump to project NCmd+P— open the recent-tabs quick-switcher
| Platform | Status |
|---|---|
| macOS 13+ (Apple Silicon / Intel) | ✅ Daily driver |
| Zsh | ✅ Daily driver |
| Bash | |
| Linux | 🚧 Untested — contributors wanted |
| Windows | 🚧 Untested — contributors wanted |
The most useful thing you can do right now is help bring Agent Terminal to Windows and Linux. The Tauri + portable-pty stack underneath supports both, but I don't run those platforms day-to-day, so the integration work isn't happening on its own.
Specifically helpful:
- Linux testers — try a dev build, file what's broken (rendering, shell integration, keyboard shortcuts, anything).
- Windows testers + developers — Windows needs ConPTY-side adjustments and a separate shell-integration path; if you're up for Tauri/Rust work, this is the highest-leverage area to contribute.
- Other agent integrations — adding Cursor and other agents is a focused PR (see CONTRIBUTING.md for the agent registry guide).
- Bug reports + feature ideas — open an issue, even rough ones.
If you're interested, open an issue or reach out on X — happy to pair / sync on direction.
Already shipped:
- ✅ Project-scoped workspaces with persistent tabs
- ✅ Live status bar (process, git, cwd, ports, model)
- ✅ Claude Code, Codex, and opencode detection and agent badges
- ✅ Agent turn detection (idle / in-progress / awaiting / done)
- ✅ Keyboard shortcuts
- ✅ Universal macOS binary (Apple Silicon + Intel)
- ✅ Theme toggle with light / dark / system support
Coming next:
- 🚧 More agent integrations (Cursor, and more)
- 🚧 Linux support
- 🚧 Windows support
- 🚧 macOS App Store distribution
For development setup, project structure, code conventions, and the MOD-system guide for adding new agents:
MIT — see LICENSE.
Copyright © 2026 Dani Akash. If you build on this project, please retain the copyright notice as required by the MIT License.