Graphify funciona no Cursor, Codex e Gemini CLI ou só no Claude Code?

Se você viu o Graphify rodando dentro do Claude Code e pensou "massa, mas eu vivo no Cursor", relaxa: a resposta curta é SIM, funciona fora do Claude Code

O Graphify é um CLI e skill que pega uma pasta com código, docs e outros arquivos e transforma tudo num grafo de conhecimento local, consultável pelo assistente de IA

Aí vem a dúvida real de quem pesquisa isso: a integração existe de verdade nas outras ferramentas, ou é aquele suporte de fachada que só aparece no README? Bora destrinchar

O que o Graphify instala em cada assistente

Antes do "onde funciona", o "o que ele faz"

O Graphify lê seu projeto com parsing AST determinístico, sem vector store no meio do caminho

Que diferença isso faz? Não tem embedding, não tem chave de API, não tem conta: é análise de estrutura do código, não busca por similaridade

O resultado sai numa pasta chamada <code>graphify-out/</code>, com três arquivos:

• <code>graphify-out/graph.json</code>: o grafo completo, que é o que o assistente consulta
• <code>graph.html</code>: uma visualização interativa pra você abrir no navegador
• <code>GRAPH_REPORT.md</code>: o relatório legível, pra humano mesmo

Formação Recomendada

Formação Vibe Coding

Do Prompt ao Produto: Crie Software Real com IA

• 474 aulas
• 20 projetos
• 39h 27min

Conhecer formação

A parte de "skill" é o que conecta isso ao seu assistente

Em vez de o agente sair lendo arquivo por arquivo pra entender o projeto, ele pergunta ao grafo

O núcleo é open source sob Apache 2.0, gratuito, sem conta, sem API key e sem cartão, e o repositório oficial fica em Graphify-Labs/graphify no GitHub (URLs antigas em <code>safishamsi/graphify</code> redirecionam pra lá)

Quem toca o projeto é a Graphify Labs, tendo Safi Shamsi como CEO e fundador

Claude Code, Cursor, Codex e Gemini CLI: como a integração muda em cada um

Aqui mora a resposta honesta

O suporte existe nos quatro, mas cada assistente expõe mecanismos diferentes, e o Graphify usa o que dá pra usar em cada um

Repara no Cursor: é UM arquivo de regra, e não um hook

O motivo está na própria página de integração: o Cursor não expõe hooks no estilo <code>PreToolUse</code>, então a regra sempre ativa é o que dá pra fazer, e ela entra em toda conversa

Já no Gemini CLI o hook <code>BeforeTool</code> casa chamadas de <code>read_file|list_directory</code> e roda <code>graphify hook-guard gemini</code>

Se você quiser um comparativo mais amplo dessas ferramentas por outro ângulo, o custo mensal de cada assistente muda bastante a escolha antes mesmo do Graphify entrar na conversa

O que você precisa antes de instalar

Esse passo é ÚNICO, não importa qual assistente você usa

O CLI vem do PyPI, e aqui tem a pegadinha número um do Graphify: o pacote se chama <code>graphifyy</code>, com dois y no final

O comando que fica instalado na sua máquina, esse sim, se chama <code>graphify</code>

Tem três formas de instalar:

# recomendado
uv tool install graphifyy

# alternativas
pipx install graphifyy
pip install graphifyy

Instalou o CLI uma vez? Beleza, agora todos os assistentes bebem da mesma fonte

Como registrar o Graphify no seu assistente (passo a passo)

1. Instale o CLI pelo PyPI com <code>uv tool install graphifyy</code> (ou pipx, ou pip)

O erro comum deste passo: digitar <code>graphifyy</code> errado, com um y só, na hora de instalar… ou digitar <code>graphify</code> com dois y na hora de RODAR

Decora assim: instala com dois, roda com um =)

2. Rode <code>graphify install</code> pra registrar a skill, lembrando que o comando puro tem o Claude Code como alvo padrão

graphify install

O erro comum deste passo: achar que o comando puro cobre todo mundo por igual

Ele mira o Claude Code por padrão, então se seu assistente principal é outro, não para por aqui, vai pro passo 3

3. Use o subcomando dedicado da sua ferramenta quando quiser garantir a integração específica

graphify claude install
graphify cursor install
graphify codex install
graphify gemini install

O erro comum deste passo: instalar pelo comando genérico, abrir o Cursor e estranhar que nada acontece

No Cursor, é o <code>graphify cursor install</code> que cria o <code>.cursor/rules/graphify.mdc</code>

4. Escolha o escopo: por padrão a skill vai pra config de usuário e vale pra TODOS os repositórios

Se você quer só no repo atual, existe a flag <code>–project</code>:

graphify install --project

O erro comum deste passo: usar <code>–project</code> num projeto, gostar do resultado, e depois passar meia hora tentando entender por que no outro repositório a skill sumiu

Não sumiu, ela nunca esteve lá =)

5. Rode <code>graphify update</code> depois de mexer no código, porque o grafo não se atualiza sozinho

graphify update

Ele faz atualização incremental, re-extraindo só os arquivos que mudaram, e sem custo de API porque é AST puro

O erro comum deste passo: refatorar meio projeto e continuar perguntando pro grafo antigo

O assistente vai responder com convicção sobre um código que não existe mais… e a culpa não é dele

Instalei, mas o assistente não chama o Graphify

Tome cuidado com esses três, são os que mais confundem

No Codex a skill não é <code>/graphify</code>

Sintoma: você digita <code>/graphify</code> e não aparece nada

Causa: no Codex o prefixo é diferente, a skill se chama <code>$graphify</code>

Solução: chame com o cifrão, <code>$graphify</code>, e não com a barra

Essa diferença de comportamento entre as duas ferramentas de terminal aparece em várias outras coisas, e vale a pena entender o contraste entre Claude Code e Codex CLI antes de culpar o Graphify

No Gemini CLI o caminho da skill muda por sistema operacional

Sintoma: você procura o arquivo da skill pra conferir se instalou e não acha nada onde esperava

Causa: o caminho é diferente conforme o SO

• macOS e Linux: <code>~/.gemini/skills/graphify/SKILL.md</code>
• Windows: <code>~/.agents/skills/graphify/SKILL.md</code>

Solução: olha no caminho certo antes de reinstalar tudo do zero

O hook do Gemini está "mudo"

Sintoma: instalou o hook <code>BeforeTool</code>, o agente lê arquivo normalmente e nenhum lembrete aparece

Causa: esse hook NUNCA bloqueia

Ele só anexa um lembrete pra consultar o grafo quando o <code>graphify-out/graph.json</code> existe, e fica silencioso quando não existe grafo nenhum

Solução: gere o grafo primeiro

Sem <code>graphify-out/graph.json</code> na jogada, o silêncio é o comportamento esperado, não é bug

Como prevenir os três: depois de instalar, confira se o <code>graphify-out/</code> foi gerado, abra o <code>graph.html</code> pra ter certeza de que o grafo existe mesmo, e só então teste a chamada da skill com o prefixo correto da sua ferramenta

Quando usar o servidor MCP em vez da skill

Aqui tem um caminho que muita gente não conhece

Além da skill, o Graphify serve o grafo por um servidor MCP, em stdio ou HTTP

Que diferença faz? Em vez de o assistente rodar o CLI, ele lê o grafo como ferramenta nativa

Dois cenários em que isso vale MUITO mais a pena:

• Você alterna entre duas ou mais ferramentas no mesmo repositório: um servidor, um grafo, vários assistentes lendo a mesma coisa, sem instalar skill em cada canto
• Seu cliente MCP não está entre os 17 assistentes suportados: se ele fala MCP, ele consegue consultar o grafo do mesmo jeito

Se você usa uma ferramenta só e ela tem subcomando dedicado, a skill resolve numa linha e tá ótimo

O MCP brilha quando o cenário é bagunçado, com várias ferramentas na mesma pasta

Funciona igual em todos? O veredito honesto

Não, e seria estranho se funcionasse

O suporte é amplo (17 assistentes, incluindo Claude Code, Cursor, Copilot, Codex, Gemini CLI e Aider), mas a profundidade da integração depende do que cada ferramenta EXPÕE

O Claude Code é o que vai mais fundo hoje, porque tem o modo estrito opcional

Com <code>–strict</code>, o lembrete suave vira um hook bloqueante: ele bloqueia a primeira leitura de código bruto da sessão e redireciona o agente pro grafo, uma vez por sessão

Ativa com <code>graphify claude install –strict</code> ou <code>graphify install –project –strict</code>, e dá pra ligar e desligar em runtime com <code>GRAPHIFY_HOOK_STRICT=1</code> ou <code>GRAPHIFY_HOOK_STRICT=0</code>

O Cursor fica no meio termo: uma regra sempre ativa, incluída em toda conversa, porque a ferramenta não expõe hooks no estilo <code>PreToolUse</code>

O Gemini CLI combina os dois mundos, regra no <code>GEMINI.md</code> mais hook, só que o hook nunca bloqueia

E o Codex tem subcomando dedicado, com a skill chamada por <code>$graphify</code>

Um aviso de honestidade: nada disso aqui é teste próprio

É leitura da documentação oficial e das páginas de integração, então trate como mapa do que ESTÁ documentado, não como benchmark de campo

Conclusão

Resposta direta pra pergunta do título: o Graphify não é só do Claude Code

Cursor, Codex e Gemini CLI têm subcomando dedicado, e a lista oficial fala em 17 assistentes suportados

O que muda é o mecanismo, porque cada ferramenta abre uma porta diferente pra integração

Próximo passo concreto, e é bem curtinho:

1. <code>uv tool install graphifyy</code>
2. <code>graphify install</code> (ou o subcomando da sua ferramenta)
3. abre o <code>graph.html</code> que apareceu em <code>graphify-out/</code> e vê seu projeto virar grafo

O núcleo é Apache 2.0 e gratuito, sem conta e sem chave de API, então dá pra experimentar sem compromisso nenhum

Quem quiser ir além do Free, a página de preços lista três planos: Free pro desenvolvedor solo, Pro pra times (hospedado, cobrado por assento) e Enterprise self-hosted

Bora testar no seu repositório? Você vai descobrir coisa do seu próprio código que nem lembrava que estava lá… 😀

até o próximo post!