A small, native macOS home for your terminal agents.
Run a dozen Claude Code and Codex sessions side by side, see at a glance which one needs you,
and pick up any of them after a quit, an update or a crash.
Install · Guide · Extending · Website · Issues
- Native and light. SwiftUI and AppKit, no Electron. Under 100 MB of memory (as Activity Monitor shows it) with a few groups loaded, under 1% CPU when idle.
- Knows what each agent is doing. A dot per tab: working, needs you, or done, with no setup. Notifications when an agent waits on you.
- Tabs that don't die. Every tab's shell runs in its own small holder process, so agents keep working when you quit, update or crash.
- A viewer above the chat. ⌘-click any path or link an agent prints to see the file, page, diff, PDF or video right there.
- A side panel to see what's going on. The tab's files, its uncommitted changes and recent commits (click one for its diff), and the workstream: agents keep a shared record of each piece of work (overview, rules, memory, questions for you, progress, files) through an MCP server.
- Extensible. Native extensions in Swift, or JSON plugins for widgets, links and themes.
- Built for vibe coding. Yours to change however you want: point your agent at the source. It comes with notes for agents (
CLAUDE.md) and a map of the code (docs/ARCHITECTURE.md).
AgentDE assumes your agents do the low-level work (editing files, running git) and focuses on how you work with them. So it's just the basics, nothing fancy: no account, no cloud backend, no phone app, no elaborate workflows. Your code, sessions and keys stay on your Mac. It lets you talk to your agents efficiently, and what else does one need?
But what if I want…
| … | Use |
|---|---|
| To edit files or run git myself | Your editor or IDE. AgentDE shows files, changes and commits, read-only |
| To reach my sessions from my phone or another computer | Claude Code's and Codex's own remote features |
| VS Code's extensions | VS Code |
| Windows or Linux | Sorry: macOS only for now. Maybe in the future |
Runs on macOS 14 or later. Building needs macOS 15.6 or later with the Xcode Command Line Tools 26 or newer (xcode-select --install; full Xcode isn't needed), and tabs need claude or codex on your PATH.
git clone https://github.com/AgentDE/agentde && cd agentde
make signing # once: so macOS remembers your permission answers
make install # about 4 minutes the first time
make register-workstream YES=1 # once: the workstream MCP server and hooks (run without YES=1 to see the changes first)The full steps, what each one changes, and uninstalling: Guide → Install.
| Repo | What |
|---|---|
| agentde | The app: groups, tabs, agent status, the viewer, search, the extension API |
| workstream-mcp | The MCP server behind workstreams. Works with plain Claude Code or Codex too, no app needed |
| agentde-workstreams | The workstream panel beside each chat, and the Usage widget |
| agentde-widgets | The sidebar widget spot, the Calendar widget, and widgets from JSON plugins |
| agentde-linear | Linear tickets in workstreams, and a widget with your open issues |
- Guide: everything AgentDE does, every key and setting, troubleshooting.
- Extending: write a native extension or a JSON plugin.
- Architecture: how it works inside.
- Roadmap: what's planned, as issues labeled
planned. - CLAUDE.md: notes for agents working on this repo.
MIT. See LICENSE.