How dedene/zentty works
Zentty is a native macOS terminal for agent-driven development, built around Ghostty. Users arrange worklanes and panes, run shell sessions or coding agents, and monitor agent and project activity from the sidebar and menu bar. The app also restores workspaces, discovers task runners and local servers, supports remote file pasting, and exposes an embedded CLI. The graph combines documented capabilities with source-index references and excerpts; many feature implementations were not sampled, so only documented or indexed relationships are connected.
Main entry points: RootViewController.swift App interface · WorklaneStore.swift Worklane state · LibghosttyView.swift Terminal surface · MainWindowController.swift Window controller
Components 22
Workspace and UI
- Window controller
Zentty/MainWindowController.swift - App interface
Zentty/UI/RootViewController.swift - Worklane canvas
Zentty/UI/Canvas/AppCanvasView.swift - Pane layout state
Zentty/Layout/PaneStripState.swift - Worklane state
Zentty/AppState/WorklaneStore.swift - Workspace restore
Zentty/Restore/SessionRestoreStore.swift
Terminal and remote
- Terminal surface
Zentty/Terminal/LibghosttyView.swift - libghostty
- Clean copy
Zentty/Terminal/CleanCopyPipeline.swift - Remote file paste
Zentty/UI/RemotePaste/RemoteImagePasteController.swift
Agent integrations
- Agent event integration
Zentty/AppState/Agent/AgentEventBridge.swift - Agent event adapters
Zentty/AppState/Agent/EventAdapters - Agent presentation
Zentty/AppState/Agent/Presentation/PresentationPipeline.swift - Agent status UI
Zentty/UI/MenuBar/MenuBarStatusController.swift - Supported agents
Zentty/AppState/Agent
Project tooling
- Server discovery
Zentty/Servers/WindowServerCommandService.swift - Task runner discovery
Zentty/TaskRunners/TaskRunnerDiscoveryService.swift - Global search
Zentty/UI/Search/GlobalSearchCoordinator.swift
Configuration and control
- App configuration
Zentty/Config/AppConfigStore.swift - Embedded CLI
ZenttyCLI/ZenttyCLI.swift
Other components
- Developer
- Coding agent
Connections 23
- Developer → Window controller: uses
README.md - Window controller → App interface: hosts
Zentty/MainWindowController.swift - App interface → Worklane canvas: displays
Zentty/UI/RootViewController.swift - App interface → Worklane state: coordinates
Zentty/UI/RootViewController.swift - Worklane state → Pane layout state: manages
Zentty/Layout/PaneStripState.swift - Worklane state → Workspace restore: restores
README.md - Worklane canvas → Terminal surface: shows panes
README.md - Terminal surface → libghostty: renders with
README.md - Developer → Clean copy: copies output
README.md - Developer → Remote file paste: pastes files
README.md - Remote file paste → Terminal surface: uploads via SSH
Zentty/UI/RemotePaste/RemoteImagePasteController.swift - Coding agent → Terminal surface: runs in pane
README.md - Coding agent → Agent event adapters: sends events
README.md - Agent event adapters → Agent event integration: adapts events
- Agent event integration → Agent presentation: resolves phase
Zentty/AppState/Agent/Presentation/PresentationPipeline.swift - Agent presentation → Agent status UI: drives status
README.md - Supported agents → Agent event integration: integrates
README.md - App interface → Server discovery: coordinates
Zentty/UI/RootViewController.swift - Server discovery → Worklane state: uses workspace state
Zentty/Servers/WindowServerCommandService.swift - App interface → Task runner discovery: discovers tasks
Zentty/UI/RootViewController.swift - Developer → Global search: searches panes
README.md - Window controller → App configuration: loads settings
Zentty/MainWindowController.swift - Developer → Embedded CLI: commands workspace
README.md