Sma1lboy/rove

Rove는 Claude Code, Codex, Copilot, Kimi, Gemini CLI, OpenCode, Cursor Agent 등 여러 코딩 작업을 병렬로 실행할 수 있는 터미널 네이티브 워크스페이스이며, 등록하는 모든 CLI도 지원합니다.

Rove는 git worktree와 브랜치 내에서 병렬 작업을 격리하며, 에이전트 및 셸 세션은 연결이 끊어져도 계속 실행됩니다.

문서 (Documentation) ·
빠른 시작 (Quick start) ·
개념 (Concepts) ·
CLI ·
에이전트 API (Agent API) ·
웹사이트 (Website)

사이드바는 작업과 해당 세션을 추적합니다. 워크스페이스는 활성 에이전트 또는 셸을 임베드합니다. 파일 창은 worktree에서 변경된 내용을 보여줍니다. 작업을 전환하여 출력을 읽거나, diff를 검사하거나, 테스트를 실행하거나, 다음 명령을 보낼 수 있습니다.

Rove를 설치한 후 저장소(repository)에서 실행하세요. Rove는 Bun ≥ 1.3.11에서 실행되며, 설치 스크립트는 Bun이 없는 경우 이를 설정해 줍니다.

curl -fsSL https://rove.run/install.sh | sh
cd your-repo
rove

n을 누르면 첫 번째 작업을 생성할 수 있습니다. git과 PATH에 지원되는 에이전트 CLI가 하나 이상 필요합니다.
; 다른 설치 방법은 Install 섹션에 있습니다.

코딩 에이전트가 Rove 자체를 구동하도록 하려면, 다음 스킬을 설치하세요:

rove skill install

git으로 격리된 병렬 작업. 각 작업은 worktree와 브랜치를 소유하므로, 리팩토링, 버그 수정, 검토가 에이전트끼리 파일을 덮어쓰지 않고 동시에 이동할 수 있습니다.모든 에이전트 CLI를 나란히. 각 작업은 자체 엔진을 선택합니다: Claude Code, Codex, Copilot, Kimi, Pi, OMP, Gemini CLI, OpenCode, Cursor Agent 등 또는 등록하는 CLI. Rove는 실제 CLI를 실행하며, 이는 자체 인증(auth), 권한(permissions), 모델을 가집니다.터미널을 초월하는 세션. TUI를 종료하거나 SSH 연결이 끊어져도 나중에 다시 연결하면 됩니다. 에이전트들은 호스트에서 계속 작업합니다.터미널 네이티브. 데스크톱 앱은 없습니다. 코드가 존재하는 곳(노트북, devbox, VPS 또는 좁은 모바일 SSH 세션)에서 Rove를 실행하세요.스크립팅 가능. 스크립트와 코딩 에이전트는 rove api를 통해 작업을 생성하고, 검사하고, 메시지를 보내고, 결과를 반영할 수 있습니다.

Managed task
├── git worktree
├── git branch
...

하나의 작업(task) 내에 있는 탭들은 파일들을 공유합니다. 따라서 격리가 필요한 작업은 별도의 관리되는 작업(managed task)을 갖게 됩니다. 프로젝트 메인 작업과 rove . 디렉토리 작업은 의도적으로 기존 디렉토리를 재사용합니다. 세션은 터미널 창 내부가 아닌 호스트에서 실행되므로, TUI(Text User Interface)에서 분리되어도 계속 진행되며, 다시 rove를 실행하면 돌아옵니다. 이 루프는 다음과 같습니다: 여러 작업을 시작하고, 그들의 실시간 세션 사이를 전환하며, 각 작업 트리(worktree)의 diff와 검사를 검토하고, 후속 지침을 보내고, 잘 된 브랜치를 병합합니다. 개념(Concepts)과 세션(Sessions)은 전체 수명 주기(full lifecycle)를 다룹니다.

위 설치 스크립트는 Rove가 필요로 하는 Bun 런타임을 설정한 다음, Rove 자체를 설정합니다. 또는 이미 가지고 있는 패키지 관리자를 사용할 수도 있습니다:

npm install -g @sma1lboy/rove # 첫 실행 시 Bun을 설치하도록 제안함
bun install -g @sma1lboy/rove # 이미 Bun을 사용 중인 경우
npx @sma1lboy/rove # 설치 없이 시도해 보기

Rove는 macOS, Linux, 그리고 Windows에서 실행됩니다. Windows의 경우 Node.js와 Git for Windows/Git Bash가 필요합니다. CLI는 Bun ≥ 1.3.11에서 실행되며, 이는 모든 설치 경로를 통해 함께 제공됩니다. 만약 사용자의 Bun이 특이한 위치에 있다면, ROVE_BUN=/path/to/bun 명령어로 Rove에게 그 위치를 알려줄 수 있습니다.

.rove는 표준 명령어입니다. 이 패키지는 또한 호환성 별칭(compatibility alias)으로 rove를 설치합니다. 첫 실행 시, 지원되는 레거시 상태가 ~/.rove에 복사되며; 기존 파일과 작업 트리는 제자리에 유지됩니다.

rove api는 동일한 작업 모델을 셸 스크립트와 코딩 에이전트에게 노출합니다. 실행(run)은 작업을 생성하고, 그 출력을 확인하며, 후속 조치를 보내고, 브랜치를 도착시킵니다:

rove api add --repo "$PWD" --prompt "Fix the flaky auth test."
rove api list
rove api read-output --task-id <id>
...

이 동반 스킬(companion skill)은 코딩 에이전트가 이 루프를 대신 구동하도록 가르칩니다:

rove skill install

다른 Rove 세션 내부에서 생성된 태스크는 자신을 전송한 태스크와 탭을 기억하므로, 워커들이 외부 코디네이터 없이 결과를 보고합니다. API는 또한 태스크 검사(task inspection), 알림(notifications), 프롬프트(prompts), 페인(panes), 이슈 추적(issue tracking), 루틴(routines), 그리고 worktree 안전한 라이프사이클 작업까지 다룹니다.

모든 동사, 플래그, 종료 코드는 Agent API 레퍼런스에 있습니다.

플러그인은 rove-plugin.toml 매니페스트와 모든 언어의 명령어들을 포함하는 디렉토리입니다. 이는 페인을 추가하고, 에이전트 턴 완료(finished agent turn) 같은 이벤트에 반응하며, 명령 및 설정을 등록하고, 전체 엔진을 기여할 수 있습니다. 터미널에서 찾아보고 설치하세요:

rowe plugin search
rowe plugin install owner/repo

동일한 카탈로그는 rove.run/plugins와 설정(Settings) → 마켓플레이스(Marketplace)에서도 확인할 수 있습니다. rove-plugin 태그가 지정된 모든 공개 GitHub 레포지토리가 여기에 표시되며, 플러그인 작성은 매니페스트, 이벤트 카탈로그, 그리고 선택적 TypeScript SDK를 다룹니다.

리뷰(Review). Diff 뷰와 더불어 하나의 에이전트 프롬프트로 돌아가는 인라인 노트입니다.복구(Recovery). 속도 제한 재개(Rate-limit resume), 크로스 엔진 핸드오프(cross-engine handoff), 단일 태스크 내 여러 에이전트입니다.원격 작업 환경(Remote ergonomics). 좁고 모바일 레이아웃, 내구성 있는 받은 편지함(Inbox), 알림, 첨부 파일입니다.비대면 작업(Unattended work). 예약된 루틴과, 유휴 실행을 건너뛰는 선택적 사전 검사(prechecks)가 있습니다.계획 컨텍스트(Planning context). 로컬 칸반(Local Kanban), GitHub 이슈 수집(issue intake), 재사용 가능한 레포지토리 필드 노트입니다.커스터마이징(Customization). 테마, 그리고 사용자 지정 페인, 이벤트, 명령어, 엔진을 가진 플러그인들입니다.

자세한 내용은 TUI 가이드, 루틴, 설정 및 플러그인 작성 섹션에서 확인할 수 있습니다.

rove doctor

문제 해결은 진단(diagnostics)과 복구 단계를 포함합니다.

bun install
bun run dev:sandbox
bun run test

CONTRIBUTING.md와 Architecture부터 시작하세요. 배포된 동작 방식은 변경 로그(changelog)에 있습니다.

MIT © Jackson Chen