RizRiyz/luvus

Luvus – AI 编码代理的任务控制 UI

它是什么 – Luvus 是一个跨平台的终端工作站，让您可以执行、监控并编排 AI 驱动的编码助手（如 Claude、GitHub Copilot、Codex、Grok、Pi 等），并与一般的 Shell、编辑器和 Git 工具并行运行。它就像终端窗格的窗口管理器，但增加了对 AI 代理、其成本、Token 使用量和会话状态的一流感知能力。

为什么重要 – 随着 AI 代码生成工具成为日常开发的一部分，开发人员需要一种方式来保持这些代理的组织性、持久性，并与版本控制工作流程集成。Luvus 提供了一个单一平台来启动代理、在重新连接时保持其上下文，并将它们与 Git 操作、工作树（worktrees）和调度任务进行协调。

核心功能（如 README 所列）

领域	Luvus 的功能
工作区持久化	将窗格、布局、终端缓冲区和命名会话存储在后台服务器上，以便您可以分离并稍后重新附加，而不会丢失状态。
窗格与分页控制	完整的鼠标、TUI 或 CLI 控制，用于分割、调整大小、缩放、移动、命名、聚焦、执行指令和关闭窗格。
代理感知	自动检测支持的 AI 编码代理，并在 UI 中显示其即时状态、Token 使用量、成本和上下文。
代理工作流程	启动、命名、发送提示、等待、恢复并向代理发送按键。支持在保留上下文的同时分叉现有会话（Claude、Grok、Codex、Pi、OMP）。
指挥官 (Commander)	底部窗格编辑器，可以使用提示或指令针对特定的代理窗格或 Shell 窗格，并可选择广播到多个目标。
文件与代码导航	Git 感知文件树、模糊搜索、文件创建/重命名、差异视图，以及在窗格、分页、预览或外部编辑器中打开文件的能力。
Git / GitHub 集成	无需离开 Luvus 即可查看仓库状态、分支、提交、贡献者、PR、问题和活动。
工作树与编排	创建 Git 工作树、排队依赖任务、调度重复性工作、强制执行质量门禁并合并结果。模块可以扩展工作树处理功能。
Luvus Web	可选的只读网页客户端，可镜像即时工作区、终端和代理标题。设备可通过链接或 QR 码配对；控制权为选择性加入，并透过 TLS 通道保护。
远程机器	存储 SSH 配置文件；在同一个 TUI 中切换本地和远程工作区，或使用 `--remote` 直接附加。远程会话可独立保持运行。
终端工具	每个窗格的滚动回溯内存、历史记录搜索、焦点历史导航、复制模式、超链接点击、剪贴板图片粘贴以及全屏终端应用程序。
可扩展性	安装模块以新增动作、事件、设置、启动钩子、新窗格、侧边栏停靠区或顶部/底部栏小工具。
通用工具协议 (UHP 1.0)	一种版本化的 IPC 方法注册表，用于构建通过精确输入、快照、事件流和语义等待与 Luvus 交互的工具和编排器。
自定义 UI	移动/调整侧边栏大小、重新映射按键、更改前缀、应用主题，并从八种语言本地化版本中选择。
跨平台交付	适用于 macOS、Linux、FreeBSD 和 Windows 的二进制文件；通过脚本、Homebrew 或 PowerShell 安装；`luvus update` 进行升级；`luvus doctor` 检查环境。

支持的 AI 编码代理（截至 README）

代理	即时状态检测	会话恢复	精确事件钩子
Claude Code	✅	✅	✅
GitHub Copilot CLI	✅	✅	✅
Codex	✅	✅	✅
Arc Studio CLI	✅	❌	❌
Antigravity CLI	✅	✅	仅限会话
Letta Code	✅	✅ (集成)	仅限会话
opencode	✅	✅	✅
Kimi	✅	✅	✅
Grok	✅	✅	✅
Hermes CLI	✅	✅ (集成)	仅限会话
Pi	✅	✅	❌
Oh My Pi (omp)	✅	✅	✅
Muse Code	✅	✅	❌
Fx	✅	✅	❌
Cursor	✅	恢复指令	❌
Kilo Code	✅	精确 ID 恢复	❌
Devin	✅	✅ (集成)	仅限会话
Gemini, Aider, Amp, Droid, Qwen, Kiro	✅	❌	❌

即时状态表示 Luvus 无需额外集成即可检测代理；恢复和钩子列表示更深层的编排支持。

入门指南（来自 README）

# 安装 (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

# 启动或重新附加到已保存的会话
luvus

# 验证您的环境 (git, gh, ssh 等)
luvus doctor

# 更新至最新版本
luvus update

在项目目录中启动后，您可以分割窗格（Ctrl‑b 风格的快捷键或鼠标）、启动 AI 代理，Luvus 将自动识别该代理并显示其状态。

典型使用案例

AI 辅助开发 – 让 Claude 或 Codex 窗格与您的编辑器和终端并行执行；从指挥官发送代码生成提示，而不会失去对主工作窗格的焦点。
多代理实验 – 在不同的窗格中执行多个代理，比较它们的输出，并立即在它们之间切换。
以 Git 为中心的工作流程 – 在编码时在停靠区查看仓库状态、PR 和问题；让代理生成 PR 描述，然后直接从 Luvus 提交。
远程结对编程 – 通过 Luvus Web 配对笔记本电脑和手机；两者都能看到相同的窗格和代理会话，实现协作式 AI 增强编程。
调度自动化 – 使用工作树编排来执行夜间 Linting 或代码生成工作，并遵守时区感知调度。

可扩展性与社区

模块可以新增侧边栏停靠区、自定义小工具，或挂钩到通用工具协议。
文档、API 参考和贡献指南托管于 luvus.dev/docs 以及仓库的 CONTRIBUTING.md。
安全性披露通过 SECURITY.md 文件处理。

授权

Apache License 2.0 (根据 LICENSE 文件)。

总结 – Luvus 是一个终端 UI“任务控制中心”，将 AI 编码代理、Shell 和 Git 工具统一到一个单一的持久化工作区中，使 AI 驱动的开发更容易组织和重现。