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 스크립트, 에디터 확장 및 데스크톱 앱을 조정하기 위해 단일 데몬을 선호하는 파워 유저.

링크

관련

  • 프로젝트
  • 프로젝트
  • 프로젝트
  • 프로젝트