O que é GitDiagram?
O GitDiagram é um app web e um projeto open source em Next.js de Ahmed Khaleel que transforma um repositório do GitHub em um diagrama de arquitetura interativo. Um modelo de IA lê a árvore de arquivos do repositório, o README e até 12 arquivos de código-fonte, escreve uma visão geral curta e devolve um grafo com no máximo 34 componentes agrupados e conexões rotuladas. Cada caminho vinculado é conferido com a árvore real antes de o grafo ser compilado para Mermaid, e cada componente abre seu arquivo ou pasta no GitHub.
Os diagramas são armazenados e compartilhados, então um repositório que alguém já diagramou abre na hora. O site também gera vídeos explicativos narrados de cerca de um minuto, exporta PNG ou o código-fonte Mermaid, oferece uma versão em Markdown de cada diagrama armazenado em gitdiagram.com/owner/repo.md e mantém um servidor MCP remoto gratuito e somente leitura em gitdiagram.com/mcp. Repositórios privados funcionam com um token do GitHub somente leitura.
O repositório foi criado em dezembro de 2024, tem licença MIT e cerca de 18.700 estrelas e 1.430 forks no GitHub. Não publica releases com tag; o último commit foi em 30 de outubro de 2026.
GitDiagram vale a pena?
O valor do GitDiagram é o fluxo de trabalho sem etapas: sem clone, sem instalação, sem chave na maioria dos usos, e um link compartilhável no fim. O pipeline por trás é mais cuidadoso do que o truque da URL sugere. Segundo a documentação de arquitetura, uma única requisição ao GPT-6 Luna com raciocínio baixo transmite uma visão geral e um grafo estrito; o servidor confere os identificadores, a conectividade e cada caminho vinculado com o repositório real, tenta de novo com feedback quando a saída é inválida, e um compilador determinístico, não o modelo, escreve o Mermaid. O navegador então sanitiza o SVG e só permite links para o GitHub. Isso torna os links confiáveis mesmo quando o desenho não é.
O teto é estrutural. O modelo vê um trecho limitado da árvore, o README e no máximo 12 arquivos de código-fonte, e desenha no máximo 34 componentes. Para uma biblioteca pequena, é suficiente; para um monorepo com dezenas de serviços, significa uma imagem grosseira em que pacotes inteiros se reduzem a uma caixa, e o próprio guia do projeto o chama de mapa das partes importantes, não de grafo completo de dependências. Repositórios muito grandes, que o GitHub devolve como árvore truncada, ainda recebem um diagrama feito a partir de uma listagem parcial, e um README grande demais é rejeitado de cara. Um diagrama armazenado também congela o repositório como ele era; Regenerate cria um novo.
O tratamento de dados do site hospedado está documentado com clareza na política de privacidade. O conteúdo do repositório vai para OpenAI, Anthropic e OpenRouter para produzir o que você pediu. Repositórios privados exigem um token fine-grained com Contents somente leitura, ou um login Continue with GitHub limitado aos repositórios que você escolher; o token fica em um cookie HttpOnly por até 30 dias e nunca é salvo no servidor, e os diagramas privados ficam em um namespace separado. O site roda gravações de sessão do PostHog, com o texto digitado mascarado. O README e a versão em Markdown trazem espaços de patrocínio pagos, da CodeRabbit no momento em que escrevemos.
Os vídeos são a parte cara e são racionados de acordo. O Claude Opus escreve o roteiro, o Claude Haiku 5.5 desenha as cenas, o Gemini 3.8 Flash TTS via OpenRouter faz a narração e o whisper-1 sincroniza as palavras; os limites padrão são um vídeo novo por navegador e 25 no site inteiro por dia UTC, com US$ 3 por vídeo além disso. Comparado ao DeepWiki, que escreve uma wiki de várias páginas com chat, o GitDiagram responde a uma pergunta mais estreita e mais rápido, e um agente de programação no seu próprio checkout vai desenhar um diagrama mais exato de código privado ou não commitado.
Onde ele se destaca
Um engenheiro de backend avaliando três bibliotecas open source de filas de tarefas
Ver como cada uma é montada antes de ler qualquer código
Troque 'hub' por 'diagram' em cada URL do GitHub; diagramas armazenados abrem na hora e os novos levam cerca de um minuto. Clique em um componente para ir à pasta dele. Gratuito dentro do limite diário; além dele, sua própria chave da OpenAI paga.
Um desenvolvedor usando Claude Code ou Codex em uma tarefa que mexe com uma dependência desconhecida
Dar ao agente a estrutura da dependência sem colar o código-fonte dela
Adicione o servidor MCP remoto com um comando e pergunte ao agente como o projeto é estruturado; ele lê a visão geral armazenada, os componentes, as conexões e o código-fonte Mermaid. Gratuito, limitado por padrão a 120 chamadas de ferramenta por hora por rede, e só para repositórios públicos.
Um líder de developer relations em uma empresa open source de 20 pessoas
Colocar uma imagem da arquitetura e um vídeo explicativo curto no README do projeto
Exporte o diagrama como PNG ou copie o código-fonte Mermaid como primeiro rascunho para editar, e baixe o vídeo explicativo em MP4 paisagem ou 9:16 com legendas embutidas. Um vídeo além da cota diária gratuita custa US$ 3.
Antes de decidir
- Configuração
- Hospedado: edite a URL ou cole owner/repo na página inicial; cerca de um minuto para um diagrama novo. Hospedado por conta própria: Bun 1.3.14 e Node 22, bun install, e depois preencha o .env com buckets do Cloudflare R2, Upstash Redis, CACHE_KEY_SECRET e uma chave da OpenAI ou do OpenRouter antes de bun run dev.
- Integrações
- Servidor MCP remoto (get_repository_diagram, find_repository_diagrams, get_explainer_video) para Claude, Claude Code, Codex, Cursor, VS Code, Gemini CLI, GitHub Copilot CLI e ChatGPT; um plugin do Claude Code com uma skill /gitdiagram; Markdown em /owner/repo.md; exportação em PNG e Mermaid.
- Dados e privacidade
- Diagramas e vídeos públicos ficam visíveis para qualquer pessoa que abra o repositório. O conteúdo do repositório vai para OpenAI, Anthropic e OpenRouter. Tokens do GitHub e chaves da OpenAI ficam em um cookie HttpOnly do navegador por até 30 dias, nunca no servidor; o token sugerido é fine-grained com Contents somente leitura. O site roda analytics e gravações de sessão do PostHog. Licença MIT.
- Custo em escala
- O site hospedado não tem assinatura. Hospedar por conta própria significa pagar R2, Upstash e tokens de modelo por diagrama; o projeto não publica um custo por diagrama, embora o app mostre uma estimativa antes de cada execução e uma faixa Fast opcional dobre o preço do modelo. Os vídeos acrescentam chamadas a Anthropic, OpenAI e OpenRouter, além de renderizações em Chromium headless.
- Limites
- Os padrões do código permitem 8 gerações pagas pelo servidor por IP por hora (quem usa chave própria fica isento) e 60 chamadas por hora aos endpoints de geração para todos. A geração tem um orçamento de 300 segundos. A criação de vídeos novos está em acesso antecipado, com limites diários. Cerca de 55 issues e pull requests abertos; sem releases com tag.
O que é bom
- Funciona editando uma URL; nada para clonar ou instalar
- Cada caminho vinculado é validado com o repositório real
- Compilador Mermaid determinístico e lista de links permitidos só para o GitHub
- Servidor MCP gratuito e somente leitura e versão em Markdown para agentes
O que não é
- No máximo 12 arquivos de código-fonte e 34 componentes, grosseiro em monorepos
- Diagramas armazenados ficam desatualizados até alguém gerá-los de novo
- Hospedar por conta própria exige Cloudflare R2, Upstash Redis e uma chave de modelo
- Espaços de patrocínio no README e na saída em Markdown
Ideal para
Engenheiros avaliando um repositório desconhecido do GitHub, e agentes que precisam de um resumo estrutural rápido de um repositório público, antes que alguém abra o código.
Alternativas ao GitDiagram
GitDiagram: perguntas frequentes
- GitDiagram vale a pena?
- O GitDiagram entrega um primeiro mapa decente de um repositório desconhecido no tempo de editar uma URL, desde que você o trate como um esboço e não como uma planta. Damos nota 4.0 de 5.
- Quanto custa GitDiagram?
- Gratuito para usar e open source (MIT). Diagramas novos são gratuitos dentro de um limite diário; depois disso, exigem sua própria chave da API da OpenAI. Vídeos explicativos além da cota diária gratuita custam US$ 3 cada.
- Quais são as desvantagens de GitDiagram?
- No máximo 12 arquivos de código-fonte e 34 componentes, grosseiro em monorepos; diagramas armazenados ficam desatualizados até alguém gerá-los de novo; hospedar por conta própria exige Cloudflare R2, Upstash Redis e uma chave de modelo; espaços de patrocínio no README e na saída em Markdown.
- Para quem GitDiagram é indicado?
- Engenheiros avaliando um repositório desconhecido do GitHub, e agentes que precisam de um resumo estrutural rápido de um repositório público, antes que alguém abra o código.
- Quanto custa GitDiagram para uma equipe ou em produção?
- O site hospedado não tem assinatura. Hospedar por conta própria significa pagar R2, Upstash e tokens de modelo por diagrama; o projeto não publica um custo por diagrama, embora o app mostre uma estimativa antes de cada execução e uma faixa Fast opcional dobre o preço do modelo. Os vídeos acrescentam chamadas a Anthropic, OpenAI e OpenRouter, além de renderizações em Chromium headless.
- GitDiagram é seguro para dados da empresa?
- Diagramas e vídeos públicos ficam visíveis para qualquer pessoa que abra o repositório. O conteúdo do repositório vai para OpenAI, Anthropic e OpenRouter. Tokens do GitHub e chaves da OpenAI ficam em um cookie HttpOnly do navegador por até 30 dias, nunca no servidor; o token sugerido é fine-grained com Contents somente leitura. O site roda analytics e gravações de sessão do PostHog. Licença MIT.
- Quais são as melhores alternativas ao GitDiagram?
- As alternativas mais próximas que analisamos são OpenWiki, Archify e Repomix.
Respostas verificadas em 31 de out. de 2026.