luvus

Luvus

Mission control for your AI coding agents.

Website · Documentation · Releases

Features

• Persistent workspaces: Open, rename, pin, and switch projects. A background server keeps tabs, panes, layouts, terminal state, and named sessions alive. Disable saved pane screens when terminal content should not be written to the session snapshot.
• Complete pane and tab control: Split, resize, zoom, move, name, focus, run, inspect, close, reorder, and swap with the mouse, TUI, or CLI.
• Agent awareness: Detect supported agents automatically and show blocked, working, done, or idle state with session titles, tokens, cost, context use, and optional sound alerts.
• Agent workflows: Start, name, message, inspect, wait for, resume, and send keys to agents. Fork Claude, Grok, Codex, Pi, and OMP sessions with their context intact.
• Commander: Send prompts to exact agent panes or commands to exact shell panes from a bottom pane-style composer. Send to several explicit targets at once without changing your current pane.
• Files and code: Browse a Git-aware file tree, inspect files and changes, fuzzy-find files, create or rename them from the FILES dock, reveal paths, and open files in a pane, tab, preview, or external editor.
• Git and GitHub: View status, branches, commits, contributors, pull requests, issues, and repository activity without leaving Luvus.
• Worktrees and orchestration: Create worktrees, coordinate dependent tasks, keep task queues and path leases scoped to their projects, assign agents, schedule timezone-aware recurring work, run quality gates, and merge completed work. Modules can provide worktree creation and removal.
• Luvus Web: An optional, read-only-by-default browser client for live workspaces, terminals, and agent session titles. Pair multiple devices by link or QR code and switch named sessions; control is opt-in. The loopback bridge needs a trusted TLS tunnel for phone access, and stopping it leaves the TUI, server, and panes running.
• Remote machines: Save SSH machine profiles and switch between local and remote workspaces in one TUI, or attach directly with --remote. Each machine targets a remote named session whose panes stay alive when you switch away; these SSH connections are separate from Luvus Web pairing.
• Terminal tools: Configure per-pane Scrollback Memory, search across pane history, jump through pane focus history, use copy mode, follow terminal hyperlinks, paste clipboard images, and run full-screen terminal apps.
• Extensible surfaces: Install modules with actions, events, settings, startup hooks, panes, sidebar docks, and Top or Bottom Luvus Bar widgets.
• Universal Harness Protocol: Build harnesses and orchestrators on the single versioned UHP 1.0 method registry, with owner-only local IPC, snapshots, event streams, exact input, and semantic waits.
• Custom interface: Move and resize two sidebars, remap keys and the prefix, use presets and a help view of effective shortcuts, select from 8 languages, and install composable local or community themes.
• Cross-platform delivery: Install on macOS, Linux, FreeBSD (amd64), or Windows, migrate from previous releases, update with luvus update, and inspect the environment with luvus doctor.

Install

# macOS, Linux, and FreeBSD
curl -fsSL https://luvus.dev/install.sh | sh

# Homebrew
brew install RizRiyz/luvus/luvus

# Windows PowerShell
irm https://luvus.dev/install.ps1 | iex

Quick start

luvus          # launch or reattach to your session
luvus doctor   # check your setup: git, gh, ssh
luvus update   # check for and install a newer release

Run Luvus in a project, split a pane, and start an agent. Luvus detects supported agents automatically.

macOS: Disable Select the previous input source under System Settings → Keyboard → Keyboard Shortcuts → Input Sources to free Ctrl+Space.

Supported agents

Live status needs no agent integration. See the documentation for setup, keybindings, modules, and the complete CLI and API reference.

Development

Read CONTRIBUTING.md for setup, tests, and pull request requirements. Native agent contributors should also read Adding Agent Support. Report vulnerabilities through SECURITY.md.

License

Apache License 2.0.