Arbor

Графовый интеллект для кодовых баз.

Узнайте, что сломается, до того, как вы это сломаете.

Оглавление

• Почему Arbor

• Что вы получаете

• Визуальный тур

• Быстрый старт

• Варианты установки

• Интеграция с MCP

• Поддержка языков

• Архитектура и документация

• Git-ориентированные CI-процессы

• Каналы релизов

• Участие в разработке

• Участники

• Безопасность

• Лицензия

Почему Arbor

Большинство инструментов ИИ для кода рассматривают код как поиск по тексту.

Arbor строит семантический граф зависимостей и отвечает на вопросы, учитывающие исполнение кода:

• Если я изменю этот символ, что сломается?

• Кто вызывает эту функцию, напрямую и транзитивно?

• Какой кратчайший архитектурный путь между этими двумя узлами?

Вы получаете детерминированный, объяснимый анализ влияния вместо приблизительного сопоставления по ключевым словам.

Что вы получаете

• Анализ радиуса поражения с уровнями достоверности и классификацией ролей

• Разрешение символов на основе графа между файлами и границами языков

• CLI + GUI + мост MCP, использующие один и тот же движок анализа

• Инкрементальная индексация для быстрой разработки во внутреннем цикле

• Git-ориентированные проверки для контроля рисков в pull-запросах

Визуальный тур

Полноэкранную запись рабочего процесса см. в 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 включает полноценный MCP-сервер через arbor bridge (транспорт stdio).

Быстрая установка 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>

Используйте GitHub Action репозитория для интеграции с CI:

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 Releases (бинарные файлы для платформ)

• crates.io

• Контейнерные образы GHCR

• Пакет-обертку npm

• Каналы расширений VS Code Marketplace / 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.