An opinionated native macOS workspace for running dozens of coding agents across repositories and worktrees. Stay oriented while they work without losing context.
Agent-agnostic. Repo-aware. Keyboard-first. Built on Ghostty.
brew tap ShravanSunder/agentstudio
brew install --cask agent-studioRequires macOS 26+. No external dependencies.
Coding agents multiply both the work you can run and the places you can lose track of it. Terminals, builds, diffs, documentation, and reviews spread across tabs, windows, and worktrees. Traditional terminal tabs flatten all of that into one long list.
Agent Studio makes the repository and worktree, not the terminal tab, the unit of organization. Panes carry repository, worktree, branch, and working-directory context. Related panes can live in a drawer. Layouts can be saved as arrangements. Source and changes open beside the terminal that prompted the work.
It is not a terminal with a few agent features added. It is a workspace for keeping agents, terminals, source, reviews, and project context together.
Give each worktree, agent session, or task a main pane. Its drawer holds the terminals and tools you choose to associate with that work.
The relationship stays simple:
┌─ MAIN PANE ─────────────────────────────────────┐
│ Agent session for feature-auth │
│ The primary unit of work │
├─ DRAWER ────────────────────────────────────────┤
│ [ Shell ] [ Diff ] [ Build ] [ Browser ] │
│ Related terminals and tools stay attached │
└─────────────────────────────────────────────────┘
Open a build log, git status, documentation, or a browser beside the agent that prompted it. The drawer travels with its main pane when you move it and closes with that pane when the work is finished.
This is what keeps you oriented. Not a flat list of 30 terminals, but a structured workspace where every pane has a home.
Choose one or more folders to watch. Agent Studio scans them for Git repositories and linked worktrees, then keeps that topology current as the filesystem changes. The repository sidebar turns those watched folders into one live map of your work: branches, checkout type, dirty changes, ahead and behind state, pull requests, unread activity, and every open pane. Jump to existing work or open a terminal, Files, or Review for any worktree.
Put Codex, Claude Code, or any CLI agent in its own pane. Each pane keeps its repository, branch, worktree, and current directory visible. Save layouts as named arrangements, or zoom one pane when the work needs focus.
Persistent terminal sessions are the default. zmx keeps their processes alive when Agent Studio closes, while the app saves the workspace around them. Reopen it to restore your tabs, panes, drawers, layouts, and visible terminal sessions instead of reconstructing the context by hand. Temporary sessions remain available for work you do not want to keep.
The command bar is one keyboard interaction model for the workspace. Press Cmd+P for Quick Find, then use # for repositories and worktrees, $ for panes and tabs, and > for commands. Recents and open-pane counts help you resume work without remembering where it lives.
Agent Studio presents every changed file as one continuous, read-only diff with file-tree navigation and syntax highlighting. The viewer is built on @pierre/diffs and @pierre/trees, then adds a demand-driven data path designed to stay responsive when a review spans thousands of changed files.
It does not render the whole change at once: metadata streams separately, visible files hydrate from viewport demand, and a worker prepares bounded render windows before budgeted main-thread updates. Scroll through large reviews without leaving the workspace. Editing stays in your editor.
- Watched folders discover repositories and linked worktrees, keep them refreshed, and collect them in one navigable sidebar.
- Structured panes and drawers keep related terminals and tools together without flattening the workspace.
- Repository-aware navigation connects panes to repositories, worktrees, branches, and working directories.
- Fast keyboard navigation uses repository, pane, tab, and command scopes with recent-item and open-pane context.
- Named arrangements and Pane Zoom let you switch between saved layouts or focus one pane without stopping the others.
- Full workspace restoration and persistent terminal sessions by default let you close the app and resume without rebuilding tabs, panes, drawers, layouts, or terminal process context.
- Built-in Files and Review viewers keep source and performant read-only diffs beside the agent doing the work.
- Review comments and annotations let you leave durable, Markdown-rendered comments on the changes you review and move between them from an annotation drawer.
- Multiple pane types let terminal, browser, and native code-viewer content share the same workspace.
These capabilities are planned, not shipped:
- Context-return workflows that send review comments back to the agent that made the change.
- Whole-workspace dynamic regrouping beyond the current repository and pane navigation.
- Sandboxed runtimes with explicit network, credential, and filesystem boundaries.
Agent Studio is AppKit-main with SwiftUI views. AtomRegistry composes one CoreAtoms graph plus explicit feature roots, while persistence wrappers store workspace, repository-cache, and local UI state. WorkspaceSurfaceCoordinator sequences cross-feature lifecycle work from the App composition root. PaneTabViewController owns pane, drawer, focus, layout, and workspace-command routing.
Pane implementations are feature slices: Terminal owns Ghostty, Webview owns browser panes, Bridge owns the React/WebKit bridge, CodeViewer owns native source viewing, CommandBar owns command-palette state, RepoExplorer owns repo/worktree navigation, and InboxNotification owns notification state. Shared pane layout primitives live in Core; reusable stateless UI primitives live in SharedComponents; domain-agnostic utilities live in Infrastructure.
Built with Swift 6.2, Swift Package Manager, Swift Testing, AppKit, SwiftUI, Observation, WebKit, Ghostty (via C API), swift-async-algorithms, and Zig build tasks. Targets macOS 26.
See the Architecture Overview for the full system design.
- macOS 26+, Xcode 26+, Swift 6
- mise (
brew install mise)
Current platform references for docs and implementation work:
- Swift documentation and Swift Package Manager
- Swift language concurrency guide
- Swift Testing
- AppKit, SwiftUI, Observation, and WebKit
- Designing for macOS
mise run doctor-mac # Check local macOS prerequisites and env hazards
mise install # Install pinned tool versions
mise run setup # Prepare or reuse vendored build inputs
mise run build # Build the Swift app
.build/debug/AgentStudio # Launchmise run test # Run tests
mise run format # Auto-format Swift sources
mise run lint # swift-format + swiftlintPlain mise run setup is the normal entry point. It builds Ghostty and zmx in
the primary worktree and reuses those prepared inputs in linked worktrees.
Developers intentionally changing Ghostty or zmx in a linked worktree can use
mise run setup --use-local-vendors to hydrate and build private vendor inputs.
If doctor-mac reports compiler or linker env pollution from Homebrew LLVM in
a vendor-producing worktree, rerun setup/build from a scrubbed shell environment
before assuming the repo build is broken locally.
git clone https://github.com/ShravanSunder/agentstudio.git agent-studio
cd agent-studio
mise install
mise run doctor-mac
mise run setupagent-studio/
├── Sources/AgentStudio/
│ ├── App/ # Composition root: boot, lifecycle, windows, panes, coordination
│ ├── Core/ # Shared models, actions, runtime contracts, atoms, persistence, pane UI
│ ├── Features/ # Terminal, Bridge, Webview, CodeViewer, CommandBar, RepoExplorer, InboxNotification
│ ├── SharedComponents/ # Stateless reusable UI primitives
│ ├── Infrastructure/ # Domain-agnostic utilities and integrations
│ └── Resources/ # App assets, terminfo, shell integration resources
├── Frameworks/ # Generated: GhosttyKit.xcframework (not in git)
├── Tests/ # Swift Testing suites plus bridge contract fixtures
├── vendor/ghostty/ # Ghostty gitlink; normally unhydrated in linked worktrees
├── vendor/zmx/ # zmx gitlink; normally unhydrated in linked worktrees
├── docs/ # Architecture, guides, plans, specs
└── Package.swift # SPM manifest
Contributions welcome. Fork, branch, test, PR. By submitting a pull request you agree to the Contributor License Agreement.