Desktop Home
Project shelves with usage rings
See active projects, budget pressure, waiting agents, and recent receipts before opening a terminal.
Mac-native agent cockpit
Externa
A desktop for agent work. Turn terminal runs into Finder-like project spaces with visible state, time, token usage, and a one-click TUI escape hatch.
Direct answer
Externa is a visual Mac layer over terminal AI agents.
It keeps terminal authority intact while making agent runs legible as openable project windows, living app icons, usage rings, and review rooms.
V1 screen system
The terminal becomes a set of Mac workspaces.
Finder Command is the baseline direction. Radial Telemetry gives token/time a shape. Raycast Dense stays available for power-user supervision.
Project Finder Window
Projects open like folders
Main threads, nested sub-agents, worktrees, and receipts live in a familiar split-view structure.
Agent Window
Agent runs become app-like objects
Each agent has state, goal, cost, progress, and a durable trail that can be reviewed without replaying the full TUI.
TUI Drawer
The terminal remains one click away
Raw terminal access appears as a lower-altitude drawer, preserving trust without making the terminal the whole product.
New Agent Sheet
Launch with budget and context
New runs start with project mapping, model choice, token guardrails, and a falsifiable goal.
Review Room
Receipts before merge
Tests, branch state, token use, and reviewer notes converge into a Mac-native approval surface.
Mac-native fit
Not a web dashboard in a window.
Externa should use SwiftUI split views, inspectors, system materials, toolbars, sheets, menu bar presence, and native notifications before custom chrome. The interface should feel closer to Finder plus Raycast than to an analytics dashboard.
- Finder structure
- Projects, agents, receipts, and worktrees remain browsable and searchable.
- Visual telemetry
- Token, cost, and time pressure use rings and small badges, not loud charts.
- Terminal authority
- The TUI is preserved as a drawer, so power users can drop down whenever needed.
Delight map
Small moments, strong operator trust.
Quiet Finish Pulse
An agent icon resolves into a brief check pulse when a run finishes, with Continue, Double-check, and Push actions close by.
Usage Ring Reveal
Opening a project draws token/time segments into view, making budget pressure visible without a spreadsheet.
Terminal Curtain
The raw TUI slides in as a lower layer with breadcrumbs intact, so visual supervision never becomes a cage.
Current status
Prototype direction is ready for review.
The identity, visual language, MagicPath screen canvases, delight map, and Mac-native assessment are assembled. The next product move is choosing the default screen direction for a SwiftUI scaffold.
Review screens