AgentDE 0.3.0

AgentDE 0.3: the first public release. It's the third iteration: 0.1 was a personal app, 0.2 rebuilt it on a minimal core with extensions, and 0.3 is that core, open source.

What AgentDE is
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 any of them up after a quit, an update or a crash.

Highlights

• A status dot per tab (working, needs you, done), with notifications when an agent waits on you.
• Tabs that survive quitting, updating and crashing: each tab's shell runs in its own small holder process.
• A viewer above the chat: ⌘-click any path or link an agent prints to see the file, page, diff, PDF, image or video, with back and forward; images zoom.
• A side panel beside the chat: the tab's Files, its Changes (uncommitted files and recent commits, diffs in the viewer, read-only) and the Workstream.
• Tab in Worktree…: a new branch checked out beside the repo with Claude or Codex in it; worktree tabs show their PR checks in the sidebar.
• Workstreams (with agentde-workstreams and workstream-mcp): overview, rules, memory, questions for you, FYI, files and artifacts beside each chat, kept by the agents and restored after every compaction.
• Recent, older and pinned sessions under each group, one click to resume; pin open tabs to the top.
• Restart Claude to pick up a Claude Code update, per tab or for every idle tab at once, keeping each session.
• Stop a background agent from the Recent list without opening it (right-click → Stop Agent).
• Native extensions in Swift, and JSON plugins for widgets, links and themes.
• Under 100 MB of memory with a few groups loaded (as Activity Monitor shows it), under 1% CPU when idle; terminal history is stored compactly.

Security and robustness (from independent code reviews)

• Terminal programs can't read your clipboard (OSC 52) unless you allow it in Settings → Terminal.
• Pages in the viewer can open other apps only on a link click.
• Large pastes no longer drop the tab's connection.
• A tab whose folder can't be entered gets a plain shell, never its startup command or agent.
• Tabs closed while starting still end their processes; one app instance per saved state.

Install
Build from source: the app runs on macOS 14 or later; building needs macOS 15.6+ with the Xcode Command Line Tools 26 or newer. See the install guide. A signed download is planned (#2).

What's next: the 0.3 milestone's planned work.

AgentDE 0.2.0

The first public release of AgentDE: a small, native macOS home for your terminal agents.

What's in it

• Groups and tabs for Claude Code, Codex and shell sessions, with a status dot per tab: working, needs you (a permission prompt or question), or done. Notifications when an agent waits on you.
• Tabs that survive quitting, updating and crashing: each tab's shell runs in its own small holder process.
• A viewer above the chat: ⌘-click any path or link an agent prints to see the file, page, diff, PDF or video, with back and forward.
• Workstreams (with the agentde-workstreams extension and workstream-mcp): overview, rules, memory, questions for you, FYI, files and artifacts beside each chat, kept by the agents and restored after every compaction.
• Recent, older and pinned sessions under each group, one click to resume.
• Native extensions in Swift, and JSON plugins for widgets, links and themes.
• Under 100 MB of memory with a few groups loaded (as Activity Monitor shows it), under 1% CPU when idle; terminal history is stored compactly.

Install

Build from source with the Xcode Command Line Tools; see the README. A signed download is planned.