Skip to main content
Harmony
Download
Harmony docs

Run every coding agent in one local workspace

Harmony is a free desktop app (plus CLI and TUI) that opens coding-agent CLIs in side-by-side tabs on your machine. Shared tasks and messages, scrollback that can survive reboot, on-device voice, and MCP tools; using the providers and subscriptions you already pay for.

Preview channel

The download page reads the release channel live and lists only builds that exist right now. Nothing is published on the channel this page can see, so there is no installer to offer and no date to invent. See platform support for exactly what exists, and the download page for the current version.

Start here

Path 1Get started with Harmony DesktopInstall the app, open your first workspace, connect a provider, and run an agent session you can actually use.Install and set up →Path 2Use the Harmony terminal agentRun the resident agent with the `nala` command in any terminal. Use slash commands, file and agent mentions, queued turns, and handoff to the desktop.Open the TUI guide →Path 3Build and integrateArchitecture, provider adapters, the A2A protocol, skills and extensions, MCP and ACP, and how to contribute.Read developer docs →

How it fits together

Harmony is not one program. Clients talk to a local daemon that owns the durable state; the session host owns the processes. Understanding this split explains most of the product.

Harmony runtime topologyFour clients — Harmony Desktop, the NALA TUI agent, the nala CLI, and external MCP hosts — connect over Electron IPC, pipe RPC, and daemon RPC to a single local daemon. The daemon owns sessions, orchestration state, tasks and artifacts, agent-to-agent messaging, and channels. Below it, the session host owns provider processes and PTYs, which in turn drive coding agent providers, terminals, the browser surface, and git worktrees. Everything runs on the local machine; no cloud host sits in the path.CLIENTSHarmony DesktopElectron rendererNALA TUInala tuinala CLIscriptableMCP hostsClaude, Codex…Client protocolElectron IPC · pipe RPC (~410 nala.* methods) · daemon RPC · Native Capability BusLOCAL DAEMONDaemon — survives app closeSessionsOrchestrationTasks + artifactsA2AChannelsSession hostOwns provider processes and PTYs · principal registration · launch reservationsRESOURCESProvidersClaude · Codex · Pi…PTYsterminal sessionsBrowserChromium · CDPWorktreesgit isolation
Every box runs on your machine. The daemon is the single durable writer for sessions, tasks, artifacts, and messages, which is why closing the desktop app does not end your work.

Jump to

The three surfaces

Harmony ships as three peers attached to one shared daemon. State flows between all three, so you can start work in one and pick it up in another.

SurfaceWhat it isBest for
Harmony desktopThe full Mission Control app: panes, tasks, messages, approvals, fleet supervisionMulti-agent control, voice-heavy sessions, many terminals
nala TUIThe resident terminal agent, in any terminalA focused coding session in the folder you are in
nala CLIScriptable, noninteractive commands on the same daemonOne-shot tasks, automation, CI, diagnostics

Start in a terminal with nala, then open the desktop attached to the same session with nala desktop. Or start in the desktop and attach a terminal later. Nothing is lost either way.

What Harmony does

Harmony works with the agents and subscriptions you already have: Claude Code, Codex, Devin, Cursor, Grok, Kimi Code, or any CLI agent you define yourself.

A terminal that never dies. Sessions live in a detached daemon. Close the app, reboot the machine, and your terminals, scrollback, and agent conversations come back exactly where they were. Suspended sessions persist for seven days.

Orchestration, locally. Durable tasks with modes and verification gates, Markdown artifacts, approval-gated agent spawning, and department-level git worktrees. The daemon is the single durable writer for all of it.

Agents that talk to each other. A durable agent-to-agent protocol (send, ask, reply, inbox) with three policy modes: Off, Connect, and Orchestrate. Loop prevention watches every conversation.

Voice, on-device. Hold the push-to-talk key (Control+Shift by default, rebindable in Settings) and speak; Whisper transcribes into the active terminal. Read Aloud speaks text back with Kokoro-82M, fully on-device, in 15 curated English voices. Enable it once, and one shortcut dictates system-wide, even when Harmony sits in the tray.

Your terminal as an agent tool. Harmony registers itself as an MCP server with Claude, Codex, and Gemini, exposing 30+ tools for workspace control, terminal routing, and browser automation. Registration is surgical: it never clobbers your own config.

A firm of agents, not a chatbot. Company mode builds an organization the way you would build a firm: a CEO agent, departments, leads, and members drawn from 40+ presets, each department in its own worktree, every member's cost tracked.

Free and local-first

Harmony itself is free, forever, and genuinely useful: the desktop app, the terminal agent, the CLI, every agent integration, on-device voice, and updates. Not a trial, not crippleware, and local use never requires an account. Everything runs on your machine: no cloud host to sign into, no inference markup. The only reporting is optional, identifier-free lifecycle telemetry, and you can switch it off with nala telemetry or NALA_TELEMETRY=0.

Harmony Managed hosted services are planned, not offered: nothing is purchasable today, and your own subscriptions, API keys, and local models will always work without them.