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) 포크 지원.
커맨더 (Commander)	특정 에이전트 창이나 셸 창을 대상으로 프롬프트나 명령을 보낼 수 있는 하단 창 컴포저. 여러 대상에 브로드캐스팅 가능.
파일 및 코드 탐색	Git 인식 파일 트리, 퍼지 검색, 파일 생성/이름 변경, diff 뷰, 창/탭/미리보기/외부 에디터에서 파일 열기 기능.
Git / GitHub 통합	Luvus를 떠나지 않고도 저장소 상태, 브랜치, 커밋, 기여자, PR, 이슈 및 활동 확인 가능.
워크트리 및 오케스트레이션	Git 워크트리 생성, 종속 작업 대기열, 반복 작업 예약, 품질 게이트 강제 및 결과 병합. 모듈을 통해 워크트리 처리 확장 가능.
Luvus 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	✅	❌	❌

실시간 상태는 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 강화 코딩 가능.
예약 자동화 – 워크트리 오케스트레이션을 사용하여 시간대별 예약을 준수하는 야간 린팅 또는 코드 생성 작업 실행.

확장성 및 커뮤니티

모듈을 통해 새로운 사이드바 독, 사용자 정의 위젯을 추가하거나 Universal Harness Protocol에 후크 가능.
문서, API 참조 및 기여 가이드는 luvus.dev/docs 및 저장소의 CONTRIBUTING.md에 호스팅됨.
보안 공개는 SECURITY.md 파일을 통해 처리됨.

라이선스

Apache License 2.0 (LICENSE 파일 참조).

결론 – Luvus는 AI 코딩 에이전트, 셸 및 Git 도구를 단일 영구 작업 공간으로 통합하는 터미널 UI "미션 컨트롤"로, AI 기반 개발을 체계적이고 재현 가능하게 만듭니다.