Repolode
Enviar
trailhq

trailhq/Trail-Code

Uma camada de contexto que aprende com o uso e dá a agentes de programação, como Claude Code e Cursor, um mapa do código e das decisões da equipe sobre ele.

Ver no GitHubSite
Estrelas
11,132
Forks
990
Issues abertas
275
Último commit
há 3 horas

O que é?

Trail-code (anteriormente graft) oferece duas coisas aos agentes de programação: um mapa do código e um repositório de aprendizados. O mapa é criado localmente com tree-sitter e registra cada arquivo, função e chamador, para que um agente encontre o código relevante e veja o que uma alteração pode afetar. Essa parte não precisa de modelo nem de API key e é atualizada conforme os arquivos mudam, inclusive com edições ainda não commitadas.

A parte de aprendizados registra o que você, seus agentes e sua equipe descobriram ou decidiram. Quando uma sessão resolve uma questão ou você corrige a forma como o trabalho é feito, o agente salva um breve arquivo Markdown no diretório .trail/learnings do repositório. Esses arquivos são commitados junto com o código, para que os agentes dos colegas partam das mesmas decisões. Aprendizados pessoais ficam em ~/.trail na sua máquina. O comando trail check compara uma branch com os aprendizados registrados antes de um PR.

O projeto é uma CLI em TypeScript instalada pelo npm. O README apresenta resultados de benchmark no SWE-bench Verified e no próprio harness do projeto, executados pelos mantenedores.

Recursos principais

  • 01Cria um grafo local do código com arquivos, funções e chamadores usando tree-sitter, sem precisar de modelo.
  • 02Atualiza o mapa do código a cada consulta para refletir edições ainda não commitadas.
  • 03Salva aprendizados como arquivos Markdown no repositório, revisados por meio de pull requests.
  • 04Executa trail check para comparar uma branch com os aprendizados registrados antes de um PR.
  • 05Mantém aprendizados pessoais em ~/.trail, que nunca é commitado.
  • 06Oferece suporte a 24 linguagens, incluindo TypeScript, Python, Go, Java e Rust.

Casos de uso

  • Dar ao Claude Code ou ao Cursor um mapa de uma base de código grande para que abra menos arquivos.
  • Registrar por que uma decisão de design foi tomada, para que sessões futuras dos agentes não a revertam.
  • Identificar alterações que entram em conflito com uma decisão registrada por um colega antes do merge.
  • Reduzir o uso de tokens e o tempo das sessões quando agentes trabalham em um repositório que não conhecem.

Início rápido

  1. 1

    Instale a CLI globalmente pelo npm

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

    No seu repositório, gere o mapa de código e configure a integração do agente

    trail init

Antes de usar

  • O Trail-code requer Node 22.3 ou superior (também funciona com 20.16), então instalações mais antigas do Node precisam ser atualizadas primeiro.
  • Os aprendizados são armazenados como arquivos no repositório, e os aprendizados pessoais ficam na sua máquina.

Em coleções

Servidores MCP para Claude CodeFerramentas, skills e plugins para Claude CodeFrameworks e apps de agentes de IA open sourceServidores MCPFerramentas de CLI e terminal

Tópicos

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

Perguntas frequentes

O que é Trail-Code?
Uma camada de contexto que aprende com o uso e dá a agentes de programação, como Claude Code e Cursor, um mapa do código e das decisões da equipe sobre ele. Trail-code (anteriormente graft) oferece duas coisas aos agentes de programação: um mapa do código e um repositório de aprendizados. O mapa é criado localmente com tree-sitter e registra cada arquivo, função e chamador, para que um agente encontre o código relevante e veja o que uma alteração pode afetar. Essa parte não precisa de modelo nem de API key e é atualizada conforme os arquivos mudam, inclusive com edições ainda não commitadas.
Trail-Code é gratuito? Qual é a licença?
Trail-Code é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
Trail-Code ainda é mantido?
Manutenção ativa. O último commit de Trail-Code foi em 7 de nov. de 2026.
Para que posso usar Trail-Code?
Dar ao Claude Code ou ao Cursor um mapa de uma base de código grande para que abra menos arquivos. Registrar por que uma decisão de design foi tomada, para que sessões futuras dos agentes não a revertam. Identificar alterações que entram em conflito com uma decisão registrada por um colega antes do merge. Reduzir o uso de tokens e o tempo das sessões quando agentes trabalham em um repositório que não conhecem.
Como instalar Trail-Code?
Instale a CLI globalmente pelo npm: npm install -g @trailhq/trail-code No seu repositório, gere o mapa de código e configure a integração do agente: trail init
Onde consigo Trail-Code?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/trailhq/Trail-Code

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados