Agent Terminal

A terminal workspace built around AI coding agents.

Status

✅ Stable on macOS + Zsh. Daily-driven, safe to install, and used every day. See the platform matrix below for other shells and operating systems.

Why this exists

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.

What you actually get

Projects and tabs that survive

Group tabs under projects (my-app, notes, infra). Switch projects without losing your place — every tab remembers its working directory and reopens there.

Live status bar

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)

Theme-aware workspace

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.

Supported agents

Want support for another agent? Open an issue or tell me on X.

Find your way back

Cmd+P opens a switcher for your recently used tabs — type a few letters, hit Enter, you're there.

Keyboard shortcuts

• Ctrl+T — new tab in the active project
• Ctrl+W — close the active tab
• Ctrl+Tab / Ctrl+Shift+Tab — cycle tabs
• Ctrl+1 … Ctrl+9 — jump to project N
• Cmd+P — open the recent-tabs quick-switcher

Tested on

🙏 Looking for contributors

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.

Roadmap

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

Contributing

For development setup, project structure, code conventions, and the MOD-system guide for adding new agents:

→ CONTRIBUTING.md

License

MIT — see LICENSE.

Copyright © 2026 Dani Akash. If you build on this project, please retain the copyright notice as required by the MIT License.