RizRiyz/luvus

Luvus – Mission‑control UI for AI coding agents

What it is – Luvus is a cross‑platform terminal‑based workstation that lets you run, monitor, and orchestrate AI‑powered coding assistants (Claude, GitHub Copilot, Codex, Grok, Pi, etc.) alongside regular shells, editors, and Git tools. It works like a window manager for terminal panes, but adds first‑class awareness of AI agents, their costs, token usage, and session state.

Why it matters – As AI code‑generation tools become part of everyday development, developers need a way to keep those agents organized, persistent, and integrated with version‑control workflows. Luvus provides a single place to launch agents, keep their context alive across re‑connections, and coordinate them with Git operations, worktrees, and scheduled tasks.

Core capabilities (as listed in the README)

Area	What Luvus does
Workspace persistence	Saves panes, layouts, terminal buffers, and named sessions on a background server so you can detach and later re‑attach without losing state.
Pane & tab control	Full mouse, TUI, or CLI control for splitting, resizing, zooming, moving, naming, focusing, running commands, and closing panes.
Agent awareness	Detects supported AI coding agents automatically and shows their live status, token usage, cost, and context in the UI.
Agent workflows	Start, name, send prompts, wait for, resume, and send keystrokes to agents. Supports forking existing sessions (Claude, Grok, Codex, Pi, OMP) while preserving context.
Commander	Bottom‑pane composer that can target specific agent panes or shell panes with prompts or commands, optionally broadcasting to multiple targets.
File & code navigation	Git‑aware file tree, fuzzy‑find, file creation/renaming, diff view, and ability to open files in panes, tabs, preview, or external editor.
Git / GitHub integration	Shows repository status, branches, commits, contributors, PRs, issues, and activity without leaving Luvus.
Worktrees & orchestration	Create Git worktrees, queue dependent tasks, schedule recurring jobs, enforce quality gates, and merge results. Modules can extend worktree handling.
Luvus Web	Optional read‑only web client that mirrors live workspaces, terminals, and agent titles. Devices can pair via link or QR code; control is opt‑in and secured via a TLS tunnel.
Remote machines	Store SSH profiles; switch between local and remote workspaces in the same TUI, or attach directly with `--remote`. Remote sessions stay alive independently.
Terminal tools	Per‑pane scrollback memory, history search, focus history navigation, copy mode, hyperlink clicking, clipboard‑image paste, and full‑screen terminal apps.
Extensibility	Install modules that add actions, events, settings, startup hooks, new panes, sidebar docks, or top/bottom bar widgets.
Universal Harness Protocol (UHP 1.0)	A versioned IPC method registry for building harnesses and orchestrators that interact with Luvus via exact input, snapshots, event streams, and semantic waits.
Custom UI	Move/resize sidebars, remap keys, change the prefix, apply themes, and select from eight language localisations.
Cross‑platform delivery	Binaries for macOS, Linux, FreeBSD, and Windows; install via script, Homebrew, or PowerShell; `luvus update` upgrades; `luvus doctor` checks environment.

Supported AI coding agents (as of the README)

Agent	Live status detection	Session resume	Precise event hooks
Claude Code	✅	✅	✅
GitHub Copilot CLI	✅	✅	✅
Codex	✅	✅	✅
Arc Studio CLI	✅	❌	❌
Antigravity CLI	✅	✅	session only
Letta Code	✅	✅ (integration)	session only
opencode	✅	✅	✅
Kimi	✅	✅	✅
Grok	✅	✅	✅
Hermes CLI	✅	✅ (integration)	session only
Pi	✅	✅	❌
Oh My Pi (omp)	✅	✅	✅
Muse Code	✅	✅	❌
Fx	✅	✅	❌
Cursor	✅	resume command	❌
Kilo Code	✅	exact‑ID resume	❌
Devin	✅	✅ (integration)	session only
Gemini, Aider, Amp, Droid, Qwen, Kiro	✅	❌	❌

Live status means Luvus can detect the agent without extra integration; resume and hook columns indicate deeper orchestration support.

Getting started (from the README)

# Install (macOS / Linux / FreeBSD)
curl -fsSL https://luvus.dev/install.sh | sh

# Homebrew (macOS/Linux)
brew install RizRiyz/luvus/luvus

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

# Launch or re‑attach to a saved session
luvus

# Verify your environment (git, gh, ssh, etc.)
luvus doctor

# Update to the latest release
luvus update

After launching inside a project directory, you can split a pane (Ctrl‑b "‑style shortcuts or mouse), start an AI agent, and Luvus will automatically recognise the agent and display its status.

Typical use cases

AI‑assisted development – Keep a Claude or Codex pane running alongside your editor and terminal; send code‑generation prompts from the Commander without losing focus on your main work pane.
Multi‑agent experimentation – Run several agents in separate panes, compare their outputs, and switch between them instantly.
Git‑centric workflow – View repository status, PRs, and issues in a dock while coding; let an agent generate a PR description and then commit directly from Luvus.
Remote pair programming – Pair a laptop and a phone via Luvus Web; both see the same panes and agent sessions, enabling collaborative AI‑augmented coding.
Scheduled automation – Use worktree orchestration to run nightly linting or code‑generation jobs with agents, respecting time‑zone aware schedules.

Extensibility & community

Modules can add new sidebar docks, custom widgets, or hook into the Universal Harness Protocol.
Documentation, API reference, and contribution guidelines are hosted at luvus.dev/docs and the repository’s CONTRIBUTING.md.
Security disclosures are handled via a SECURITY.md file.

License

Apache License 2.0 (per the LICENSE file).

Bottom line – Luvus is a terminal‑UI “mission control” that unifies AI coding agents, shells, and Git tooling into a single, persistent workspace, making it easier to keep AI‑driven development organized and reproducible.