RizRiyz/luvus

Luvus – AIコーディングエージェントのためのミッションコントロールUI

概要 – Luvusは、AI搭載のコーディングアシスタント（Claude、GitHub Copilot、Codex、Grok、Piなど）を、通常のシェル、エディタ、Gitツールと並行して実行、監視、オーケストレーションできるクロスプラットフォームのターミナルベースのワークステーションです。ターミナルペインのウィンドウマネージャーのように機能しますが、AIエージェント、そのコスト、トークン使用量、セッション状態に対するファーストクラスの認識機能が追加されています。

重要性 – AIコード生成ツールが日常的な開発の一部となるにつれ、開発者はそれらのエージェントを整理し、永続化し、バージョン管理ワークフローと統合する方法を必要としています。Luvusは、エージェントを起動し、再接続時にもコンテキストを維持し、Git操作、ワークツリー、スケジュールされたタスクと連携させるための単一の場所を提供します。

主な機能（READMEより）

機能領域	Luvusの役割
ワークスペースの永続化	ペイン、レイアウト、ターミナルバッファ、名前付きセッションをバックグラウンドサーバーに保存し、状態を失うことなくデタッチおよび再アタッチが可能。
ペインとタブの制御	マウス、TUI、CLIによる完全な制御。分割、サイズ変更、ズーム、移動、名前付け、フォーカス、コマンド実行、ペインのクローズが可能。
エージェント認識	サポートされているAIコーディングエージェントを自動検出し、ライブステータス、トークン使用量、コスト、コンテキストをUIに表示。
エージェントワークフロー	エージェントの起動、名前付け、プロンプト送信、待機、再開、キー入力送信。コンテキストを保持したまま既存セッション（Claude、Grok、Codex、Pi、OMP）のフォークをサポート。
コマンダー	特定のエージェントペインやシェルペインをターゲットにプロンプトやコマンドを送信できるボトムペインコンポーザー。複数ターゲットへのブロードキャストも可能。
ファイルとコードのナビゲーション	Git対応のファイルツリー、ファジー検索、ファイル作成/名前変更、差分表示、ペイン・タブ・プレビュー・外部エディタでのファイルオープン機能。
Git / GitHub統合	Luvusを離れることなく、リポジトリステータス、ブランチ、コミット、コントリビューター、PR、Issue、アクティビティを表示。
ワークツリーとオーケストレーション	Gitワークツリーの作成、依存タスクのキューイング、定期ジョブのスケジュール、品質ゲートの強制、結果のマージ。モジュールによるワークツリー処理の拡張が可能。
Luvus Web	ライブワークスペース、ターミナル、エージェントタイトルをミラーリングするオプションの読み取り専用Webクライアント。リンクまたはQRコードでペアリング可能。制御はオプトインでTLSトンネルにより保護。
リモートマシン	SSHプロファイルの保存。同一TUI内でローカルとリモートのワークスペースを切り替え、または`--remote`で直接アタッチ。リモートセッションは独立して維持。
ターミナルツール	ペインごとのスクロールバックメモリ、履歴検索、フォーカス履歴ナビゲーション、コピーモード、ハイパーリンククリック、クリップボード画像貼り付け、フルスクリーンターミナルアプリ。
拡張性	アクション、イベント、設定、スタートアップフック、新しいペイン、サイドバードック、トップ/ボトムバーウィジェットを追加するモジュールをインストール可能。
Universal Harness Protocol (UHP 1.0)	正確な入力、スナップショット、イベントストリーム、セマンティック待機を通じてLuvusと対話するハーネスやオーケストレーターを構築するためのバージョン管理されたIPCメソッドレジストリ。
カスタムUI	サイドバーの移動/サイズ変更、キーの再マッピング、プレフィックスの変更、テーマの適用、8つの言語ローカライズからの選択が可能。
クロスプラットフォーム配信	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	✅	❌	❌

ライブステータスは追加の統合なしでエージェントを検出できることを意味し、再開およびフック列はより深いオーケストレーションサポートを示します。

はじめに（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、Issueを表示。エージェントにPR説明を生成させ、Luvusから直接コミット。
リモートペアプログラミング – Luvus Web経由でノートPCとスマートフォンをペアリング。両者で同じペインとエージェントセッションを共有し、共同でのAI拡張コーディングを実現。
スケジュール自動化 – ワークツリーオーケストレーションを使用して、タイムゾーンを考慮したスケジュールで夜間のLintingやコード生成ジョブを実行。

拡張性とコミュニティ

モジュールにより、新しいサイドバードックやカスタムウィジェットの追加、Universal Harness Protocolへのフックが可能。
ドキュメント、APIリファレンス、貢献ガイドラインは luvus.dev/docs およびリポジトリの CONTRIBUTING.md にホストされています。
セキュリティ開示は SECURITY.md ファイルを通じて処理されます。

ライセンス

Apache License 2.0 (LICENSEファイル参照)。

結論 – Luvusは、AIコーディングエージェント、シェル、Gitツールを単一の永続的なワークスペースに統合するターミナルUIの「ミッションコントロール」であり、AI主導の開発を整理し、再現性を高めることを容易にします。