Arbor

Inteligencia nativa de grafos para bases de código.

Sabe qué se rompe antes de que lo rompas.

Tabla de contenidos

• Por qué Arbor

• Qué obtienes

• Recorrido visual

• Inicio rápido

• Opciones de instalación

• Integración MCP

• Soporte de lenguajes

• Arquitectura y documentación

• Flujos de trabajo de CI con conocimiento de Git

• Canales de lanzamiento

• Contribución

• Colaboradores

• Seguridad

• Licencia

Por qué Arbor

La mayoría de las herramientas de código basadas en IA tratan el código como una recuperación de texto.

Arbor construye un grafo de dependencias semánticas y responde a preguntas conscientes de la ejecución:

• Si cambio este símbolo, ¿qué se rompe?

• ¿Quién llama a esta función, directa y transitivamente?

• ¿Cuál es el camino arquitectónico más corto entre estos dos nodos?

Obtienes un análisis de impacto determinista y explicable en lugar de coincidencias de palabras clave aproximadas.

Qué obtienes

• Análisis del radio de explosión con niveles de confianza y clasificación de roles

• Resolución de símbolos respaldada por grafos a través de archivos y límites de lenguaje

• CLI + GUI + puente MCP compartiendo el mismo motor de análisis

• Indexación incremental para un desarrollo rápido en el bucle interno

• Comprobaciones con conocimiento de Git para puertas de riesgo en solicitudes de extracción (pull requests)

Recorrido visual

Para una grabación a pantalla completa del flujo de trabajo, consulta media/recording-2026-01-13.mp4.

Inicio rápido

# 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

Opciones de instalación

Utiliza el canal que mejor se adapte a tu entorno:

# 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

Instaladores sin 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

Para instalaciones fijadas/versionadas, consulta docs/INSTALL.md.

Integración MCP

Arbor incluye un servidor MCP real a través de arbor bridge (transporte stdio).

Instalación rápida de Claude Code

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

Configuración multi-cliente

• Guía completa: docs/MCP_INTEGRATION.md

• Plantillas listas: templates/mcp/

• Scripts de arranque:

  • scripts/setup-mcp.sh

  • scripts/setup-mcp.ps1

Verificación de registro (autoritativa)

• Nombre de registro: io.github.Anandb71/arbor

• Búsqueda oficial de API: https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.Anandb71/arbor

Soporte de lenguajes

Arbor admite el análisis de producción y el análisis de grafos en los principales ecosistemas:

• Rust

• TypeScript / JavaScript

• Python

• Go

• Java

• C / C++

• C#

• Dart

• Kotlin (analizador de respaldo)

• Swift (analizador de respaldo)

• Ruby (analizador de respaldo)

• PHP (analizador de respaldo)

• Shell (analizador de respaldo)

Notas detalladas del analizador y guía de expansión:

• docs/ADDING_LANGUAGES.md

• docs/ARCHITECTURE.md

Arquitectura y documentación

Empieza aquí cuando necesites profundizar en los aspectos internos:

• docs/QUICKSTART.md

• docs/ARCHITECTURE.md

• docs/GRAPH_SCHEMA.md

• docs/PROTOCOL.md

• docs/MCP_INTEGRATION.md

• docs/ROADMAP.md

Flujos de trabajo de CI con conocimiento de Git

Arbor admite comprobaciones de riesgo previas a la fusión y control de cambios:

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

Utiliza la GitHub Action del repositorio para la integración de 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

Canales de lanzamiento

La distribución automatizada de lanzamientos incluye:

• GitHub Releases (binarios de plataforma)

• crates.io

• Imágenes de contenedor GHCR

• Paquete contenedor npm

• Canales de extensión de VS Code Marketplace / Open VSX

• Homebrew + Scoop

Manual de operaciones: docs/RELEASING.md

Contribución

Las contribuciones son bienvenidas.

• Empieza con: CONTRIBUTING.md

• Código de conducta: CODE_OF_CONDUCT.md

• Política de seguridad: SECURITY.md

• Buenas primeras tareas: docs/GOOD_FIRST_ISSUES.md

Para desarrollo local:

cargo build --workspace
cargo test --workspace

Colaboradores

Seguridad

Arbor está diseñado para ser local desde el principio:

• Sin exfiltración de datos obligatoria

• Flujos de trabajo capaces de funcionar sin conexión

• Rutas de código de código abierto

Informa de vulnerabilidades a través de SECURITY.md.

Licencia

MIT — ver LICENSE.