Graphify: um grafo de conhecimento do código para o Claude Code
O Graphify transforma um repositório — código, documentação, esquemas SQL, configurações, PDFs — num grafo de conhecimento consultável de dentro do Claude Code. Análise local com tree-sitter, cada aresta etiquetada, sem armazenamento vetorial.
Graphify num relance
- Um projeto de código aberto de terceiros (Graphify-Labs/graphify, Apache-2.0, escrito em Python), não um produto da Anthropic. Oferece uma skill `/graphify` para Claude Code, Cursor, Codex, Gemini CLI e outros assistentes.
- O código é analisado com tree-sitter num AST, localmente e de forma determinística, sem chamada a modelo. Cada aresta é marcada como `EXTRACTED` (explícita na fonte) ou `INFERRED` (resolvida pelo Graphify).
- É um grafo que se percorre, não um índice vetorial: sem embeddings e sem armazenamento vetorial. O `/graphify query` devolve apenas os nós e arestas de que a resposta precisa.
- Três comandos bastam: `uv tool install graphifyy`, `graphify install` e `/graphify .` dentro do repositório. A saída aparece em `graphify-out/`.
Graphify-Labs/graphify — repository and README
Fontegithub.com2026-11-15
Graphify Quickstart
Fontedocs.graphify.com2026-11-15
GitHub REST API — repos/Graphify-Labs/graphify
Fonteapi.github.com2026-11-15
Todos os comandos, opções e nomes de ficheiro desta página foram lidos das três fontes acima em 2026-11-15. Comandos e caminhos ficam sem tradução de propósito: um comando traduzido não corre.
Verificado em 2026-11-15. O ramo predefinido é v8 e o último push foi em 2026-11-14; as contagens de estrelas e forks mudam todos os dias, por isso volta a ler a API antes de as citar.
O que o Graphify é de facto
A descrição do próprio projeto: transformar qualquer base de código, com a sua documentação, esquemas SQL, configurações e PDFs, num grafo de conhecimento consultável — uma skill `/graphify` para Claude Code, Cursor, Codex e Gemini CLI, com análise AST local e determinística, cada aresta explicada e sem armazenamento vetorial.
Na prática instalas uma CLI (`graphify`) e uma skill e depois escreves `/graphify` dentro do assistente. O assistente corre deteção, extração e agrupamento, escreve o grafo em `graphify-out/` e, a partir daí, responde percorrendo esse grafo em vez de fazer grep à árvore.
- Licença
- Apache-2.0
- Linguagem
- Python (pacote graphifyy)
- Estrelas / forks
- 147,983 / 14,194 — instantâneo de 2026-11-15
- Estado
- Terceiros; ramo predefinido v8; último push 2026-11-14
Não é um projeto da Anthropic
O Graphify é publicado pela organização Graphify-Labs (a API do GitHub indica is_verified: false) sob Apache-2.0. A Anthropic não o mantém e o Claude Code não o inclui: instalas tu, e ele trabalha sobre os teus ficheiros.
Como o grafo é construído
O código é analisado com tree-sitter num AST. Essa passagem é determinística e corre na tua máquina: sem LLM e sem nada sair dela. As ligações entre ficheiros (calls, imports, inherits, mixes_in) saem do AST em cerca de 40 linguagens, e os comentários `# NOTE:` / `# WHY:`, tal como referências a ADR e RFC, também se tornam nós.
Documentação, PDFs, imagens e vídeo passam por uma segunda passagem semântica que usa o modelo do teu assistente ou uma chave de API configurada. É essa a parte que gasta tokens; o mapa do código não.
Cada aresta é explicada
Cada ligação traz uma etiqueta: `EXTRACTED` quando a relação é explícita na fonte, `INFERRED` quando foi o Graphify a resolvê-la. Vês o que foi lido do código e o que foi deduzido.
Não é um índice vetorial
Não há embeddings nem armazenamento vetorial. A saída é um grafo real — nós, arestas, comunidades, god nodes — que percorres com `query`, `path` e `explain`.
Instalar o Graphify para o Claude Code
Três comandos. O Claude Code é o destino predefinido do `graphify install`; outro assistente está a uma opção de distância.
Instala a CLI
O pacote é `graphifyy` — com dois y. Instala os comandos `graphify` e `graphify-mcp`. Requer Python 3.10 ou superior e serve qualquer dos três gestores de pacotes.
# Python 3.10 or lateruv tool install graphifyy# or: pipx install graphifyy# or: pip install graphifyyAtenção à grafia: instala-se `graphifyy`, mas escrevem-se `graphify` e `graphify-mcp`.
Regista a skill
Sem opções, `graphify install` aponta ao Claude Code: copia a skill para `~/.claude/skills/graphify/SKILL.md` e registra-a em `~/.claude/CLAUDE.md`. Para outro agente, passa `--platform`.
graphify install# Claude Code (default): ~/.claude/skills/graphify/SKILL.md# registered in ~/.claude/CLAUDE.md# another assistant: graphify install --platform codexPor exemplo `graphify install --platform codex`. Se `/graphify` continuar a não ser reconhecido, reinicia o assistente ou confirma que `~/.claude/skills/graphify/SKILL.md` existe.
Corre-o num repositório
Abre o repositório no assistente e corre `/graphify .`. O agente deteta, extrai e agrupa e depois reporta; o código é analisado localmente e a documentação e os artigos passam pelo modelo do próprio agente.
/graphify .Depois pergunta: `/graphify query "how does authentication reach the database"` devolve só os nós e arestas necessários, cortados a um orçamento de tokens.
Antes de começar
- 1Python 3.10 ou superior.
- 2uv, pipx ou pip — o que já usas para CLIs.
- 3Um assistente de código suportado pelo `graphify install` (Claude Code por omissão) e um repositório para indexar — local, ou um URL público do GitHub para `/graphify <url>`.
Os comandos que vais mesmo usar
Copiados tal e qual do quickstart e da tabela de comandos da documentação. Os que começam por `/` escrevem-se no assistente; os restantes correm numa shell.
| Comando | O que faz |
|---|---|
/graphify query "…" | Faz uma pergunta e devolve só os nós e arestas necessários, cortados a um orçamento de tokens. |
/graphify path "AuthModule" "Database" | Mostra o caminho mais curto entre dois nós — aqui de AuthModule para Database. |
/graphify explain "SessionStore" | Explica um nó: o que é, com o que se liga e porquê. |
/graphify . --update | Atualiza um grafo existente em vez de o reconstruir de raiz. |
/graphify . --mode deep | Corre o modo de extração mais profundo — mais lento, mas resolve mais relações. |
/graphify . --wiki | Produz também uma descrição do grafo ao estilo wiki. |
/graphify https://github.com/<owner>/<repo> | Aponta a um repositório público por URL em vez de um caminho local. |
graphify hook install | Instala hooks de git (post-commit, post-checkout, post-merge, post-rewrite e um merge driver) para o grafo seguir o repositório; o `graphify hook status` deve então listar os quatro como installed. |
graphify god-nodes --top 5 | Imprime os nós mais ligados — uma verificação rápida de que o grafo existe e faz sentido. |
graphify extract . --code-only | Volta a extrair apenas com a passagem de código, saltando os passos de LLM para documentação e multimédia. |
graphify uninstall | Remove a skill e os seus registos. |
Se um comando não encontrar o grafo, corre-o a partir da pasta que contém `graphify-out/`, ou passa `--graph graphify-out/graph.json`.
O que aparece em graphify-out/
A árvore da documentação, tal e qual:
graphify-out/├── graph.json├── graph.html├── GRAPH_REPORT.md├── manifest.json└── cache/- 1`graph.json` — o grafo completo, e o ficheiro que outras ferramentas leem.
- 2`graph.html` — vista no navegador: clicar nos nós, filtrar, pesquisar.
- 3`GRAPH_REPORT.md` — os destaques, as ligações inesperadas e perguntas sugeridas.
- 4`manifest.json` — o manifesto do que foi indexado.
- 5`cache/` — dados de trabalho locais; mete-o no `.gitignore` em vez de o comitar.
O que comitar
A documentação sugere comitar `graph.json` e `GRAPH_REPORT.md` e pôr `cache/` no `.gitignore`. A versão curta do README fala em «três ficheiros» (`graph.html`, `GRAPH_REPORT.md`, `graph.json`), enquanto o quickstart lista cinco entradas. Ambos descrevem a mesma pasta com níveis de detalhe diferentes.
Um grafo guardado regista também `graph.schema_version` e `graph.graphify_version`. Verifica-os depois de atualizar a CLI: um grafo antigo pode precisar de reconstrução.
Manter o grafo atualizado
Um grafo vale o que vale a última compilação, por isso liga-o ao git:
graphify hook installgraphify hook status# → 4 hooks installed, merge driver: registeredO `graphify hook install` liga os hooks post-commit, post-checkout, post-merge e post-rewrite mais um merge driver. Depois disso, o `graphify hook status` deve mostrar os quatro como installed e «merge driver: registered».
Quando a documentação ou as imagens mudarem, volta a correr `/graphify . --update` em vez de uma compilação completa.
Quando encaixa e o que não faz
O Graphify é uma ferramenta de mapas de código. Vale a instalação quando a forma de um repositório importa mais do que o texto de um ficheiro isolado.
Encaixa bem
- 1Estás a entrar numa base de código desconhecida e queres ver os módulos, os god nodes e as comunidades antes de ler ficheiros.
- 2A pergunta é de relação — como é que isto chega àquilo, quem chama isto — e o grep responde mal a isso.
- 3Queres o mapa comitado, para uma equipa ou um agente o reler sem pagar uma reconstrução.
Limites a conhecer
- 1A parte gratuita e totalmente local cobre o código. Documentação, PDFs, imagens e vídeo passam por um modelo na passagem semântica, por isso essas partes custam tokens ou uma chave de API.
- 2As arestas `INFERRED` são uma resolução do Graphify, não um facto da fonte. Lê a etiqueta antes de confiar numa ligação.
- 3O grafo é um instantâneo. Sem os hooks ou o `--update` fica desatualizado como um README.
- 4É um projeto de terceiros recente: o argumento a favor vem do próprio README, não de uma avaliação independente.
O projeto publica no README a sua própria tabela de benchmarks — por exemplo um recall@10 de LOCOMO de 0,497 com n=300. São medições dos mantenedores, não um resultado independente, por isso trata-as como uma afirmação a verificar no teu próprio repositório.
Graphify no DeepSeek Harness
Há também um plugin nativo de terceiros para o DeepSeek Harness, listado no diretório de plugins. É trabalho da comunidade, independente do repositório Graphify-Labs.
Ver a ficha do plugin