Sobre o projeto

GitNexus (da Akon Labs) é um mecanismo de inteligência de código que transforma um repositório em um grafo de conhecimento consultável. Em vez de entregar arestas brutas do grafo a um agente de IA e esperar que ele explore o suficiente, ele pré-computa a estrutura no momento da indexação — clustering, rastreamento de cadeias de chamadas e pontuação de confiança — para que uma única chamada de ferramenta possa retornar contexto completo sobre um símbolo, seus dependentes e os fluxos de execução dos quais ele participa. Como funciona Executar `npx gitnexus analyze` a partir da raiz de um repositório indexa a base de código, instala habilidades de agente, registra hooks para editores suportados e gera arquivos de contexto AGENTS.md / CLAUDE.md. `npx gitnexus setup` escreve a configuração MCP para que editores como Claude Code, Cursor, Codex, Antigravity, Windsurf, OpenCode, CodeBuddy e Qoder possam consultar o grafo. A análise usa Tree-sitter (bindings nativos para a CLI, WASM para o navegador), e os índices são armazenados em LadybugDB — nativos e persistentes para a CLI, WASM em memória para a interface web. Dois modos de uso O caminho CLI + MCP é voltado para o desenvolvimento diário: indexe localmente e deixe o agente consultar o grafo. A interface web (hospedada em gitnexus.vercel.app ou auto-hospedada) oferece um explorador visual de grafos além de chat com IA, limitado pela memória do navegador, a menos que um backend seja usado. Um modo de ponte, `gitnexus serve`, permite que a interface web detecte um servidor local e navegue por repositórios indexados pela CLI sem reenviar ou reindexar. Superfície MCP Dezessete ferramentas MCP são expostas (15 por repositório mais 2 de nível de grupo), incluindo `query` (busca híbrida BM25 + semântica + RRF), `context` (visão de símbolo em 360 graus), `impact` (análise de raio de explosão), `trace` (caminho direcionado mais curto entre símbolos), `detect_changes` (mapeamento de impacto por git-diff), `rename`, `cypher` para consultas brutas ao grafo, além de auxiliares de rota/ferramenta/formato/impacto de API e `explain` e `pdg_query` baseados em PDG para análise de taint e dependência em nível de declaração. Recursos MCP complementares fornecem listas de repositórios, clusters, processos, esquemas e contratos de grupo, e dois prompts (`detect_impact`, `generate_map`) orientam a análise pré-commit e a documentação de arquitetura. Habilidades de agente e fluxos de trabalho As habilidades são instaladas em `.claude/skills/` e espelhadas em `.agents/skills/` quando presente, cobrindo exploração, depuração, análise de impacto, refatoração, uso da CLI, consultas PDG e análise de taint. Fluxos de trabalho no estilo slash-command incluem plan, work, review e um pipeline completo plan→work→review. Com `--skills`, a detecção de comunidades Leiden identifica áreas funcionais e gera habilidades de projeto por área, descrevendo arquivos-chave, pontos de entrada e conexões entre áreas. Implantação e operações Existem modelos de implantação com um clique para Render (um serviço de servidor privado mais um serviço web público com autenticação baseada em token) e RepoCloud. O README documenta ressalvas de instalação em relação ao npm 11, gramáticas opcionais do Tree-sitter, ambientes restritos por proxy e downloads do runtime de embeddings, além de um modo MCP somente leitura e uma política de repositórios permitidos para restringir quais repositórios os agentes podem acessar. O licenciamento é PolyForm Noncommercial, com uma oferta comercial SaaS/auto-hospedada do fornecedor.