https://github.com/daniakash/agent-terminal
A terminal that understands AI agents. Project workspaces, live process metrics, and native Claude Code + Codex support.
https://github.com/daniakash/agent-terminal
ai-agents claude-code codex developer-tools productivity react terminal terminal-app terminal-emulator xterm
Last synced: about 7 hours ago
JSON representation
A terminal that understands AI agents. Project workspaces, live process metrics, and native Claude Code + Codex support.
- Host: GitHub
- URL: https://github.com/daniakash/agent-terminal
- Owner: DaniAkash
- License: mit
- Created: 2026-04-18T16:25:10.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-05-20T03:40:52.000Z (about 1 month ago)
- Last Synced: 2026-06-09T12:24:15.511Z (20 days ago)
- Topics: ai-agents, claude-code, codex, developer-tools, productivity, react, terminal, terminal-app, terminal-emulator, xterm
- Language: TypeScript
- Homepage:
- Size: 8.63 MB
- Stars: 29
- Watchers: 1
- Forks: 4
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# Agent Terminal
**A terminal workspace built around AI coding agents.**
[](https://github.com/DaniAkash/agent-terminal/releases)
[](#status)
[](https://github.com/DaniAkash/agent-terminal/releases)
---
## Status
> 🧪 **Pre-alpha.** Heavily tested on **macOS + Zsh** — that's the daily-driver setup. Other shells and platforms may work but aren't part of the test matrix yet. Things will change without warning.
## Why this exists
If you live in a terminal alongside [Claude Code](https://claude.ai/code), [Codex](https://github.com/openai/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
| Agent | Status |
|---|---|
| [Claude Code](https://claude.ai/code) | ✅ Supported |
| [Codex CLI](https://github.com/openai/codex) | ✅ Supported |
| [Gemini CLI](https://github.com/google-gemini/gemini-cli) | 🔜 Planned |
| [Cursor](https://www.cursor.com) | 🔜 Planned |
| [Open Code](https://github.com/sst/opencode) | 🔜 Planned |
Want support for another agent? [Open an issue](https://github.com/DaniAkash/agent-terminal/issues/new) or [tell me on X](https://x.com/dani_akash_).
### 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
| Platform | Status |
|---|---|
| macOS 13+ (Apple Silicon / Intel) | ✅ Daily driver |
| Zsh | ✅ Daily driver |
| Bash | ⚠️ Should work, lightly tested |
| Linux | 🚧 Untested — contributors wanted |
| Windows | 🚧 Untested — contributors wanted |
## 🙏 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 Gemini CLI, Cursor, Open Code, etc. is a focused PR (see [CONTRIBUTING.md](./CONTRIBUTING.md) for the MOD system guide).
- **Bug reports + feature ideas** — open an issue, even rough ones.
If you're interested, [open an issue](https://github.com/DaniAkash/agent-terminal/issues/new) or [reach out on X](https://x.com/dani_akash_) — 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 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 (Gemini CLI, Cursor, Open Code)
- 🚧 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](./CONTRIBUTING.md)**
---
## License
MIT — see [LICENSE](./LICENSE).
Copyright © 2026 [Dani Akash](https://github.com/DaniAkash). If you build on this project, please retain the copyright notice as required by the MIT License.