brainiphy
instalar

Documentación · Sincronización e indexado

Mantenerlo cierto, con una frecuencia.

Construir el grafo es la parte fácil. Esta es la parte que decide si la respuesta que recibas dentro de seis semanas sigue siendo la buena: qué hace una pasada de sincronización, cómo la ejecuta macOS mientras no miras, y cuánto cuesta indexar de verdad.

Re-sincronizar no duplica nunca un registro — el motivo está en la primera sección. Lo que alimenta una sincronización se describe en los siete pasos.

Sincronizar y programar

Cada fuente dice cada cuánto hay que revisarla. brain sync ejecuta las que tocan — registradas en connectors/state/<nombre>.json — y reconstruye el grafo solo si alguna llegó a ejecutarse. Así que lanzarlo a menudo sale barato.

$ brain sync ~/clients/acme             # solo lo que toca
$ brain sync ~/clients/acme --dry-run   # qué se ejecutaría, sin tocar nada
$ brain sync ~/clients/acme --full      # releer y reindexar todo

Dos pasadas de reconstrucción, y elegir la equivocada no hace nada en silencio

brain sync elige por ti. Esta tabla importa cuando lo automatizas tú por tu cuenta.

PasadaIndexaNecesita modeloCuándo la usa brain
graphify extractdocumentos y códigosí, para documentosprimera construcción, y cada --full
graphify updatesolo código (AST local)nocada ejecución manual posterior

Dejar que lo haga macOS

$ brain schedule ~/clients/acme --interval-minutes 15 --load

Escribe un LaunchAgent en ~/Library/LaunchAgents/com.graphify.sync.<slug>.plist. Sin --load solo escribe el plist e imprime el comando launchctl bootstrap. Se niega a ejecutarse si el proyecto no tiene conectores registrados — programar un bucle de sincronización sin nada que sincronizar es una operación vacía y silenciosa, incómoda de depurar después.

Indexado, modelos y coste

Indexar código es una pasada local sobre el AST, sin ningún modelo de por medio. Indexar documentos — las propuestas, las notas, los registros del CRM — sí lo necesita. Eso no significa que necesite una factura nueva.

brain sync elige backend en este orden:

  1. 1--backend <nombre>, si le pasas uno.
  2. 2La clave de API que haya en el entorno — ANTHROPIC_API_KEY, GEMINI_API_KEY, OPENAI_API_KEY, y demás.
  3. 3Tu suscripción de Claude Code, cuando no hay ninguna de las dos y el CLI claude está instalado. graphify llama por debajo a claude -p, así que el indexado se carga a tu plan Pro o Max en vez de a crédito de API de pago por uso.
$ brain sync ~/clients/acme --full --backend claude-cli   # forzar la suscripción
$ export GRAPHIFY_CLAUDE_CLI_MODEL=haiku                  # más rápido y ligero que el Opus por defecto

El backend de la suscripción procesa un fragmento cada vez, así que una primera sincronización grande es más lenta que con una clave de API. Un modelo local también vale: --backend ollama.