# Harmony Desktop Source: https://docs.ideharmony.com/desktop Harmony Desktop is the full-surface client. Everything the TUI can do, plus the things that genuinely benefit from pixels: many terminals at once, a browser surface, diffs, and a live roster of the agents you have running. ```powershell harmony desktop ``` ## The three-level model | Level | What it is | Notes | |---|---|---| | **Workspace** | A named context with its own pane tree, working directory, and status | One project each | | **Surface** | A tab within a workspace — terminal, browser, editor, diff, file tree, or a Harmony panel | | | **Pane** | A leaf in the split tree | Max 20 per workspace | A pane is not an agent. A pane can hold a plain shell forever and never involve a model. ## What is in the window | Region | Holds | |---|---| | **Sidebar** | Workspaces, layout presets, missions, company panel | | **Surface tabs** | The tabs within the current workspace | | **Pane area** | Your splits | | **Status bar** | App menu, clock, usage, git branch, window controls | | **Orchestration bar** | A2A mode, YOLO/Safe toggle, provider quick-launch | ## Terminals The hero surface: xterm.js rendering, PTY owned by the main process, session owned by the daemon. That split is why closing the window does not kill your shell. Included: in-terminal search, a context menu, vi copy mode, line bookmarks, scrollback persistence, shell integration with prompt marks, and a shell allowlist. `Ctrl+B` is a literal tmux-style prefix on **every** platform, including macOS. While it is armed, global shortcuts are suppressed. ## Other surfaces | Surface | What it does | |---|---| | **Browser** | Embedded Chromium with a toolbar, partitioned profiles, and an element inspector aimed at agents | | **Editor** | File editing alongside your terminals | | **Diff** | Review changes before integrating them | | **File tree** | Navigate the project | | **Search results** | Project-wide search | | **Symbol explorer / repository map** | Structural views of the codebase | ## Agents and fleet The orchestration bar launches providers directly. FleetView shows the live roster across the workspace, with an approval inbox and a remote inbox for peer-machine messages. > [!WARNING] > FleetView has a known defect where the roster can show more agents live than > actually exist. Treat the count as a hint, not a fact, and confirm against > task state. See [known limitations](/docs/reference/known-limitations). ## Approvals Actions that change your machine or repository can require explicit consent. Approvals surface as dialogs and in the fleet approval inbox. > [!IMPORTANT] > Read approval prompts rather than clearing them. The prompt is the cheap > moment to say no. Repository content, model output, and browser content are > all untrusted inputs — see [security](/docs/security). ## Settings Thirteen tabs, including General, Appearance, Notifications, Tools, Shortcuts, Claude Code integration, Harmony orchestration, Workspaces, text-to-speech, speech-to-text, LAN Link, first-run setup, and About. Notable defaults worth knowing: | Setting | Default | |---|---| | YOLO (inject provider full-access flags on launch) | **On** | | A2A mode | Off / Connect / Orchestrate | > [!SECURITY] > YOLO defaults to on. It injects full-access flags into provider launches, > which removes friction and also removes a safety rail. If you are pointing > agents at a repository you care about, look at this setting before your first > real session. ## Theming Built-in themes: `nala-stream` (the default), `nala-classic`, `catppuccin-mocha`, `monochrome`, `stars-and-stripes`, `red-dynasty`, `nightowl`, `void`, `hinomaru`, `taegeuk`, `gatsby`, and two glass themes, `azure-glass` and `magenta-glass`. There is also a custom theme editor with ten tokens and an xterm palette. Density presets: airy, balanced, dense. The UI ships in 23 locales. ## Crash restore If the app exits unexpectedly, a restore banner offers to bring your panes back, with a progress list as they reattach. ## Related - [Your first workspace](/docs/getting-started/first-workspace) - [Keyboard shortcuts](/docs/desktop/keyboard-shortcuts) - [Voice](/docs/desktop/voice) - [Session survival](/docs/concepts/session-survival)