Quickstart

luvus is mission control for your AI coding agents: split panes, a live sidebar of every agent’s state, sessions that survive closing the terminal, and tools to run many agents on one project without conflicts.

Install

macOS / Linux

curl -fsSL https://luvus.dev/install.sh | sh

Prebuilt binaries for Apple silicon and Linux (x86_64 / arm64).

Homebrew

brew install RizRiyz/luvus/luvus

Windows

irm https://luvus.dev/install.ps1 | iex

Use luvus inside Windows Terminal.

Run it

luvus          # launch or reattach to your session
luvus doctor   # check your setup: git, gh, ssh, and what each unlocks

That’s genuinely it. luvus starts a background server that owns your panes and attaches a lightweight client. Close the terminal any time and everything keeps running. Start your agents in panes like you normally would, and luvus recognizes them automatically and shows their live state in the sidebar.

macOS: free the prefix key

macOS reserves Ctrl+Space for input-source switching, which blocks luvus’s prefix. Untick Select the previous input source under System Settings → Keyboard → Keyboard Shortcuts… → Input Sources. Everything is also fully mouse-driven, so nothing else is blocked in the meantime.

Next steps

Your first session

A five-minute tour: split panes, run an agent, detach, come back. Take the tour →

Work with agents

Live states, sound alerts, zero-config session resume, integrations. Agent guide →

Run agents in parallel

The orchestration board: isolated worktrees or shared-workspace task tabs, path leases, quality gates, and merge gates. Orchestration →

Script everything

Every UI action is a CLI command over a local socket. Scripting →

Build on Luvus

Universal Harness Protocol (UHP) is the stable automation surface for coding harnesses, integrations, remote clients, and developer tools. Start with the UHP overview, then use the copyable examples or the complete method reference.