Repolode
Enviar
trailhq

trailhq/Trail-Code

Una capa de contexto que aprende y ofrece a agentes de programación como Claude Code y Cursor un mapa de tu código y las decisiones que tomó tu equipo.

Ver en GitHubSitio web
Estrellas
11,101
Forks
986
Issues abiertos
275
Último commit
hace 21 horas

¿Qué es?

Trail-code (antes graft) ofrece dos cosas a los agentes de programación: un mapa del código y un repositorio de aprendizajes. El mapa se construye localmente con tree-sitter y registra cada archivo, función y llamador, para que un agente encuentre el código pertinente y vea qué podría romper un cambio. Esta parte no necesita ningún modelo ni API key y se actualiza cuando cambian los archivos, incluidos los cambios sin commit.

La parte de aprendizajes captura lo que tú, tus agentes y tu equipo han descubierto o decidido. Cuando en una sesión se resuelve algo o corriges cómo se hace el trabajo, el agente guarda un archivo Markdown breve en el directorio .trail/learnings del repositorio. Estos archivos se incluyen en los commits junto con el código, así que los agentes de tus compañeros parten de las mismas decisiones. Los aprendizajes personales se guardan en ~/.trail en tu máquina. El comando trail check compara una rama con los aprendizajes registrados antes de crear un PR.

El proyecto es una CLI de TypeScript que se instala desde npm. Su README informa de los resultados de benchmarks en SWE-bench Verified y en su propio harness, que los responsables del proyecto ejecutaron por su cuenta.

Funciones clave

  • 01Crea un grafo local del código con archivos, funciones y llamadores mediante tree-sitter, sin necesitar un modelo.
  • 02Actualiza el mapa del código en cada consulta para que refleje los cambios sin commit.
  • 03Guarda los aprendizajes como archivos Markdown en el repositorio, que se revisan mediante pull requests.
  • 04Ejecuta trail check para comparar una rama con los aprendizajes registrados antes de crear un PR.
  • 05Mantiene los aprendizajes personales en ~/.trail, sin incluirlos nunca en commits.
  • 06Admite 24 lenguajes, entre ellos TypeScript, Python, Go, Java y Rust.

Casos de uso

  • Proporcionar a Claude Code o Cursor un mapa de una base de código grande para que abra menos archivos.
  • Registrar por qué se tomó una decisión de diseño para evitar que futuras sesiones con agentes la deshagan.
  • Detectar cambios que entran en conflicto con una decisión registrada por un compañero antes de hacer el merge.
  • Reducir el uso de tokens y el tiempo de sesión cuando los agentes trabajan en un repositorio que no conocen.

Inicio rápido

  1. 1

    Instala la CLI globalmente desde npm

    npm install -g @trailhq/trail-code
  2. 2

    En tu repositorio, genera el mapa de código y configura la integración del agente

    trail init

Antes de usarlo

  • Trail-code necesita Node 22.3 o posterior (también funciona con 20.16), así que primero tendrás que actualizar las instalaciones de Node más antiguas.
  • Los aprendizajes se guardan como archivos en el repositorio, y los aprendizajes personales se quedan en tu equipo.

En colecciones

Servidores MCP para Claude CodeHerramientas, skills y plugins para Claude CodeFrameworks y apps de agentes de IA open sourceServidores MCPHerramientas de CLI y terminal

Temas

#ai-agents#claude-code#code-graph#context-engineering#mcp#tree-sitter#llm#developer-tools#anthropic#cli

Preguntas frecuentes

¿Qué es Trail-Code?
Una capa de contexto que aprende y ofrece a agentes de programación como Claude Code y Cursor un mapa de tu código y las decisiones que tomó tu equipo. Trail-code (antes graft) ofrece dos cosas a los agentes de programación: un mapa del código y un repositorio de aprendizajes. El mapa se construye localmente con tree-sitter y registra cada archivo, función y llamador, para que un agente encuentre el código pertinente y vea qué podría romper un cambio. Esta parte no necesita ningún modelo ni API key y se actualiza cuando cambian los archivos, incluidos los cambios sin commit.
¿Trail-Code es gratuito? ¿Qué licencia tiene?
Trail-Code es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿Trail-Code sigue mantenido?
Mantenimiento activo. El último commit de Trail-Code fue el 5 nov 2026.
¿Para qué puedo usar Trail-Code?
Proporcionar a Claude Code o Cursor un mapa de una base de código grande para que abra menos archivos. Registrar por qué se tomó una decisión de diseño para evitar que futuras sesiones con agentes la deshagan. Detectar cambios que entran en conflicto con una decisión registrada por un compañero antes de hacer el merge. Reducir el uso de tokens y el tiempo de sesión cuando los agentes trabajan en un repositorio que no conocen.
¿Cómo se instala Trail-Code?
Instala la CLI globalmente desde npm: npm install -g @trailhq/trail-code En tu repositorio, genera el mapa de código y configura la integración del agente: trail init
¿Dónde consigo Trail-Code?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/trailhq/Trail-Code

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados