Deepseek ArtifactsDeepseek Artifacts
Terceiros · Apache-2.0 · Python

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

Abrir

Graphify Quickstart

Fontedocs.graphify.com2026-11-15

Abrir

GitHub REST API — repos/Graphify-Labs/graphify

Fonteapi.github.com2026-11-15

Abrir

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 graphifyy

Atençã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 codex

Por 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.

ComandoO 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 . --updateAtualiza um grafo existente em vez de o reconstruir de raiz.
/graphify . --mode deepCorre o modo de extração mais profundo — mais lento, mas resolve mais relações.
/graphify . --wikiProduz 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 installInstala 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 5Imprime os nós mais ligados — uma verificação rápida de que o grafo existe e faz sentido.
graphify extract . --code-onlyVolta a extrair apenas com a passagem de código, saltando os passos de LLM para documentação e multimédia.
graphify uninstallRemove 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: registered

O `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

Graphify: perguntas frequentes

Continuar a ler