penso/arbor
Run agentic coding workflows in a fully native desktop app for Git worktrees, terminals, and diffs.
Arbor – AI 지원 코딩을 위한 네이티브 데스크톱 환경
소개 – Arbor는 완전히 네이티브한 Rust 애플리케이션(데스크톱 GUI, 웹 UI 및 CLI)으로, 여러 Git 리포지토리, 워크트리, 터미널 및 장기 실행 프로세스를 관리하면서 AI 코딩 에이전트(Claude, Codex, Gemini, Ollama 등)를 긴밀하게 통합할 수 있습니다. 모든 구성 요소가 단일 데몬과 통신하므로 GUI, 웹 대시보드 및 명령줄 도구가 동일한 상태를 공유합니다.
핵심 기능(README 설명 기준)
| 영역 | Arbor의 기능 |
|---|---|
| 리포지토리 및 워크트리 | 여러 리포지토리에 걸친 워크트리 나열/생성/삭제; GitHub/GitLab 이슈에서 직접 워크트리 생성; 정리된 이름 미리보기; arbor.toml을 통한 리포지토리 로컬 브랜치 명명 규칙 강제; 마지막 활동 타임스탬프 표시; 이슈와 브랜치/PR 자동 연결. |
| 임베디드 터미널 및 프로세스 | TrueColor를 지원하는 내장 PTY 터미널, 워크트리당 여러 탭, 선택적 실험적 Ghostty 엔진, 앱 재시작 후에도 유지되는 데몬 기반 세션, Procfile 또는 arbor.toml에 정의된 관리 프로세스(자동 재시작, 메모리 메트릭, 신호 처리). |
| Diff 및 PR 리뷰 | 행 수 통계가 포함된 나란히 보기(side-by-side) diff 뷰, 파일 트리 브라우징, 다중 탭 diff, PR 요약 카드, 인라인 댓글 작업 및 새로 고침. |
| AI 에이전트 채팅 | 다양한 에이전트(Claude, Codex, Gemini, Ollama, LM Studio, OpenRouter, 모든 OpenAI 호환 /v1/chat/completions 엔드포인트)를 위한 채팅 창. 자동 모델 검색, 공급자별 선택기, 스트리밍 응답(SSE/JSONL), 세션 지속성, 토큰 사용량 표시. |
| 에이전트 가시성 | 실행 중인 코딩 에이전트를 감지하고 작업/대기 상태를 색상 점으로 표시하며, WebSocket을 통해 데스크톱과 웹 UI 모두 실시간 업데이트. |
| 원격 데몬 및 MCP | arbor-httpd는 원격 HTTP API와 번들된 웹 UI를 제공; arbor-cli는 데몬 기반 명령을 제공; arbor-mcp는 에디터/IDE 확장을 위한 stdio 서버 클라이언트. 인증된 원격 데몬, SSH/Mosh 아웃포스트, 다중 호스트 구성 및 선택적 Symphony 오케스트레이션 런타임 지원. |
| UI 및 테마 | 3개 창 레이아웃, 명령 팔레트, 크기 조절 가능한 창, 38개의 공유 테마, 실시간 테마 동기화, 데스크톱 알림, 브랜치 인식 창 제목. |
설치
- macOS –
brew install penso/tap/arbor - Linux / Windows – GitHub Releases 페이지에서 사전 빌드된 바이너리 다운로드.
- 소스에서 설치 – 리포지토리 복제, Rust nightly
2025‑11‑30설치,just설치 후just run(GUI) 또는just run-mcp(MCP 서버) 실행. 플랫폼별 설정 스크립트는 README 참조(just setup-macos,just setup-linux).
빠른 시작(README의 CLI 예제)
# 상태 확인
cargo run -p arbor-cli -- health
# 워크트리를 JSON으로 나열
cargo run -p arbor-cli -- worktrees list --json
# 관리 프로세스 나열
cargo run -p arbor-cli -- processes list --json
# 예약 작업 나열
cargo run -p arbor-cli -- tasks list --json
구성(리포지토리 로컬)
각 리포지토리는 다음을 정의하는 arbor.toml을 포함할 수 있습니다:
- 프리셋(예: 프롬프트 파일을 사용하여
codex를 실행하는 "Review" 명령) - 프로세스(이름, 명령, 작업 디렉토리, 자동 시작/재시작 설정)
- 설정/해제 스크립트
- 브랜치 명명 규칙
- 에이전트 기본값 및 체크포인트
- 알림(데스크톱, Webhook URL, 이벤트 필터)
- 예약 작업(cron 스타일 스케줄 및 선택적 AI 트리거 프롬프트).
전역 사용자 구성은 ~/.config/arbor/config.toml에 위치하며 공급자 정의, 테마 선택 및 선택적 임베디드 터미널 엔진 선택이 포함됩니다.
아키텍처 참고 사항
- 데몬(
arbor-httpd)은 단일 진실 공급원(single source of truth)을 유지하며 GUI(arbor-gui), 웹 UI(arbor-web-ui), CLI(arbor-cli) 및 MCP 서버(arbor-mcp)에서 사용하는 REST 스타일 API를 노출합니다. - MCP(Message Control Protocol)를 통해 외부 도구가 stdio를 통해 데몬과 통신하여 에디터 확장을 가능하게 합니다.
- Ghostty VT 엔진은
ghostty-vt-experimental기능 플래그로 활성화할 수 있는 선택적 실험적 터미널 백엔드입니다. - 이 프로젝트는 Zed의 GPU 가속 UI 프레임워크인 GPUI를 기반으로 구축되었습니다.
권장 사용자
- 여러 리포지토리에서 작업하며 워크트리, 터미널 및 AI 기반 코딩 지원을 위한 통합 UI가 필요한 개발자.
- 클라우드 전용 AI 코딩 어시스턴트 대신 자체 호스팅 가능한 네이티브 대안을 원하는 팀.
- CLI 스크립트, 에디터 확장 및 데스크톱 앱을 조정하기 위해 단일 데몬을 선호하는 파워 유저.
링크
- 라이브 문서: https://penso.github.io/arbor/docs/
- 소스: https://github.com/penso/arbor
- 릴리스 페이지: https://github.com/penso/arbor/releases
- 유사 도구: Superset, Jean, Conductor (README에 언급됨).
관련
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트