Arbor

코드베이스를 위한 그래프 기반 지능.

문제가 발생하기 전에 무엇이 고장날지 파악하세요.

목차

• Arbor를 사용하는 이유

• 제공 기능

• 시각적 둘러보기

• 빠른 시작

• 설치 옵션

• MCP 통합

• 언어 지원

• 아키텍처 및 문서

• Git 인식 CI 워크플로우

• 릴리스 채널

• 기여 방법

• 기여자

• 보안

• 라이선스

Arbor를 사용하는 이유

대부분의 AI 코드 도구는 코드를 텍스트 검색으로 취급합니다.

Arbor는 의미론적 의존성 그래프를 구축하고 실행을 인식하는 질문에 답합니다:

• 이 심볼을 변경하면 무엇이 고장나는가?

• 이 함수를 직접적, 간접적으로 호출하는 곳은 어디인가?

• 이 두 노드 사이의 가장 짧은 아키텍처 경로는 무엇인가?

근사치에 기반한 키워드 매칭 대신 결정론적이고 설명 가능한 영향 분석을 얻을 수 있습니다.

제공 기능

• 신뢰 수준 및 역할 분류를 포함한 영향 범위(Blast radius) 분석

• 파일 및 언어 경계를 넘나드는 그래프 기반 심볼 해석

• 동일한 분석 엔진을 공유하는 CLI + GUI + MCP 브리지

• 빠른 내부 루프 개발을 위한 증분 인덱싱

• 풀 리퀘스트 위험 관문을 위한 Git 인식 검사

시각적 둘러보기

워크플로우의 전체 화면 녹화는 media/recording-2026-01-13.mp4를 참조하세요.

빠른 시작

# 1) Install Arbor CLI
cargo install arbor-graph-cli

# 2) Initialize in your repository
cd your-project
arbor setup

# 3) Explore impact before refactor
arbor refactor <symbol-name>

# 4) Optional: run git-aware checks
arbor diff
arbor check --max-blast-radius 30

# 5) Launch GUI
arbor gui

설치 옵션

환경에 맞는 채널을 사용하세요:

# Rust / Cargo
cargo install arbor-graph-cli

# Homebrew (macOS/Linux)
brew install Anandb71/tap/arbor

# Scoop (Windows)
scoop bucket add arbor https://github.com/Anandb71/arbor
scoop install arbor

# npm wrapper (cross-platform)
npx @anandb71/arbor-cli

# Docker
docker pull ghcr.io/anandb71/arbor:latest

Rust를 사용하지 않는 설치 프로그램:

• macOS/Linux: curl -fsSL https://raw.githubusercontent.com/Anandb71/arbor/main/scripts/install.sh | bash

• Windows PowerShell: irm https://raw.githubusercontent.com/Anandb71/arbor/main/scripts/install.ps1 | iex

고정/버전별 설치는 docs/INSTALL.md를 참조하세요.

MCP 통합

Arbor는 arbor bridge (stdio 전송)를 통해 실제 MCP 서버를 포함합니다.

Claude Code 빠른 설치

claude mcp add --transport stdio --scope project arbor -- arbor bridge
claude mcp list

다중 클라이언트 설정

• 전체 가이드: docs/MCP_INTEGRATION.md

• 준비된 템플릿: templates/mcp/

• 부트스트랩 스크립트:

  • scripts/setup-mcp.sh

  • scripts/setup-mcp.ps1

레지스트리 검증 (권위 있는 소스)

• 레지스트리 이름: io.github.Anandb71/arbor

• 공식 API 조회: https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.Anandb71/arbor

언어 지원

Arbor는 주요 생태계 전반에 걸쳐 프로덕션 수준의 파싱 및 그래프 분석을 지원합니다:

• Rust

• TypeScript / JavaScript

• Python

• Go

• Java

• C / C++

• C#

• Dart

• Kotlin (대체 파서)

• Swift (대체 파서)

• Ruby (대체 파서)

• PHP (대체 파서)

• Shell (대체 파서)

상세한 파서 참고 사항 및 확장 가이드:

• docs/ADDING_LANGUAGES.md

• docs/ARCHITECTURE.md

아키텍처 및 문서

더 깊은 내부 구조가 필요할 때 여기서 시작하세요:

• docs/QUICKSTART.md

• docs/ARCHITECTURE.md

• docs/GRAPH_SCHEMA.md

• docs/PROTOCOL.md

• docs/MCP_INTEGRATION.md

• docs/ROADMAP.md

Git 인식 CI 워크플로우

Arbor는 병합 전 위험 검사 및 변경 사항 게이팅을 지원합니다:

arbor diff
arbor check --max-blast-radius 30
arbor open <symbol>

CI 통합을 위해 리포지토리 GitHub Action을 사용하세요:

name: Arbor Check
on: [pull_request]

jobs:
  arbor:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v5
      - uses: Anandb71/arbor@release/v1.8
        with:
          command: check . --max-blast-radius 30

릴리스 채널

자동화된 릴리스 배포에는 다음이 포함됩니다:

• GitHub 릴리스 (플랫폼 바이너리)

• crates.io

• GHCR 컨테이너 이미지

• npm 래퍼 패키지

• VS Code 마켓플레이스 / Open VSX 확장 채널

• Homebrew + Scoop

런북: docs/RELEASING.md

기여 방법

기여를 환영합니다.

• 시작하기: CONTRIBUTING.md

• 행동 강령: CODE_OF_CONDUCT.md

• 보안 정책: SECURITY.md

• 좋은 첫 번째 작업: docs/GOOD_FIRST_ISSUES.md

로컬 개발을 위해:

cargo build --workspace
cargo test --workspace

기여자

보안

Arbor는 설계상 로컬 우선입니다:

• 필수적인 데이터 유출 없음

• 오프라인 가능 워크플로우

• 오픈 소스 코드 경로

취약점은 SECURITY.md를 통해 보고하세요.

라이선스

MIT — LICENSE를 참조하세요.