O que é OpenWiki?
O OpenWiki é um projeto da LangChain em que um agente de programação pesquisa um repositório e escreve uma wiki em Markdown com links em uma pasta openwiki/, e depois a mantém atualizada. Cada afirmação factual é guardada como um Grounded Claim que aponta para evidências versionadas no código-fonte, como um arquivo e um intervalo de linhas, então uma atualização reescreve só as páginas cujas evidências mudaram, e uma atualização limpa não faz nenhuma chamada de modelo.
Ele roda de duas formas: dentro de um agente de programação que você já usa (Codex, Claude Code, OpenCode, Cursor, GitHub Copilot CLI, Kiro, IBM Bob, Antigravity, Oh My Pi ou Pi), usando a sessão de modelo desse agente, ou como CLI independente sobre o próprio agente de documentação Deep Agents, com catorze provedores de modelo. Ele mantém um bloco no AGENTS.md, expõe ferramentas locais de busca e leitura via MCP, liga wikis de vários repositórios em workspaces e escreve no Open Knowledge Format v0.2 do Google.
O repositório foi criado em 22 de junho de 2026, tem licença MIT e cerca de 17,600 estrelas no GitHub. O pacote npm está na 0.7.2 (9 de outubro de 2026) e foi baixado cerca de 66,000 vezes na última semana de outubro.
OpenWiki vale a pena?
O OpenWiki resolve o problema que afunda a maior parte da documentação gerada: ela apodrece, e ninguém sabe quais partes. Ao vincular cada fato a evidências versionadas no código-fonte, ele consegue perceber na execução seguinte que uma afirmação sobre o tratamento de retentativas cita linhas que já mudaram de lugar, e devolver só essa página ao modelo. Repositórios sem mudanças não custam nada para atualizar, porque a verificação roda antes de qualquer chamada de modelo. As páginas são salvas uma por vez, então uma execução interrompida é retomada em vez de recomeçar.
O modelo de integração é o ganho prático. Rodando dentro do Claude Code ou do Codex, ele usa a sessão autenticada e as ferramentas do agente, então não há uma segunda chave de API nem uma segunda conta para administrar; o agente faz a pesquisa e a escrita, enquanto o OpenWiki cuida da fila, da contabilidade das afirmações e dos índices finais. Suas ferramentas MCP de busca e leitura são locais, somente leitura e não fazem chamadas de modelo, e as instruções gerenciadas dizem aos agentes para consultar a wiki quando houver perguntas concretas em vez de carregá-la no início de cada tarefa. Jobs agendados no GitHub Actions, GitLab e Bitbucket abrem um pull request de documentação quando a wiki muda.
Os padrões merecem atenção. A telemetria vem ligada: um único evento por init ou update com o comando, o resultado e, na configuração, os nomes do provedor e dos conectores, nunca código nem prompts; OPENWIKI_TELEMETRY_DISABLED=1 ou DO_NOT_TRACK=1 a desliga. O visualizador de grafo carrega suas bibliotecas de uma CDN pública, então não funciona offline. Um .openwikiignore impede que caminhos sejam lidos, mas o README observa que o agente ainda pode deduzir uma área ignorada a partir de testes ou mensagens de commit.
Os limites são os de um projeto de quatro meses que anda rápido: versão 0.7.2, cerca de 208 issues e pull requests abertos, e um grounding de afirmações que até agora cobre só o código do repositório, não os conectores de wiki pessoal (Notion, Gmail, Slack, X) nem os traces do LangSmith. Comparado ao Repomix, que empacota um repositório em um único prompt a cada vez, o OpenWiki custa uma geração completa no início e recupera isso em cada pergunta posterior e em cada atualização incremental.
Onde ele se destaca
Uma equipe de plataforma responsável por repositórios de control plane, data plane e infraestrutura
Deixar os agentes responderem perguntas entre repositórios sem carregar os três códigos
Gerar uma wiki em cada repositório, agrupá-las com openwiki link em um workspace, e os agentes buscam nos três pelas ferramentas MCP locais. Rodando pelo Claude Code ou Codex, não acrescenta conta de modelo além da sessão do próprio agente.
Uma gerente de engenharia em uma empresa de 30 desenvolvedores com documentação de onboarding desatualizada
Manter a documentação de arquitetura em dia sem designar alguém para isso
Adicionar o workflow agendado do GitHub Actions com um token fine-grained para que ele abra um pull request só de documentação sempre que afirmações ficarem desatualizadas; os revisores fazem o merge como de qualquer outra mudança. Semanas sem mudanças não fazem chamadas de modelo.
Um staff engineer entrando em um repositório grande e desconhecido
Obter um mapa preciso do código em uma tarde
Instalar a integração com o Claude Code e pedir ao agente que inicialize o OpenWiki a partir do código e dos testes, depois abrir openwiki visualize para ver um grafo ao lado de um leitor de Markdown. Espere que a primeira geração consuma tokens equivalentes a uma sessão completa do agente.
Antes de decidir
- Configuração
- npm install -g openwiki (Node 22.22.0+), openwiki integrations install claude (ou codex, cursor e outros), reiniciar o agente e pedir que ele inicialize a wiki. Independente: openwiki --init guia pela escolha de provedor, chave e modelo.
- Integrações
- Dez hosts de agentes de programação; catorze provedores para a CLI independente, incluindo OpenAI (padrão gpt-5.6-terra), Anthropic, Bedrock, Vertex, Copilot e endpoints compatíveis com OpenAI, como Ollama; templates de CI para GitHub, GitLab e Bitbucket; conectores de Notion, Gmail, Slack, X, busca na web e Hacker News para uma wiki pessoal.
- Dados e privacidade
- A wiki e as afirmações são arquivos comuns no seu repositório; as chaves ficam em ~/.openwiki/.env. A telemetria envia um evento anônimo por init ou update por padrão; OPENWIKI_TELEMETRY_DISABLED=1 desativa. O conteúdo do repositório vai para o provedor de modelo ou agente host que você usar. Licença MIT.
- Custo em escala
- Software gratuito. A primeira geração de um repositório grande é a etapa cara; execuções nativas podem documentar até 8 páginas em paralelo, e atualizações posteriores só pagam pelas páginas cujas evidências mudaram. Por um agente host, o custo fica dentro dessa assinatura.
- Limites
- Cerca de 208 issues e pull requests abertos na 0.7.2; execuções conduzidas pelo host são sequenciais e cobrem só wikis de código; gateways só de streaming podem devolver uma wiki em branco, a menos que o streaming seja forçado; saldos baixos no OpenRouter podem gerar erros 402 sem um limite de saída.
O que é bom
- Grounded Claims vinculam cada fato a linhas versionadas do código-fonte
- Atualizações sem mudanças pulam totalmente as chamadas de modelo
- Roda dentro de dez agentes de programação, na sessão que eles já têm
- Busca MCP local e somente leitura entre repositórios ligados
O que não é
- Telemetria ligada por padrão
- O visualizador exige uma CDN pública, então não há visualização offline
- O grounding de afirmações cobre só código, não conectores
- Antes da 1.0, com cerca de 208 issues e PRs abertos
Ideal para
Equipes cujos agentes de programação vivem redescobrindo o mesmo código e que querem uma wiki que se atualiza em pull requests em vez de ficar defasada.
Alternativas ao OpenWiki
OpenWiki: perguntas frequentes
- OpenWiki vale a pena?
- O OpenWiki é a primeira ferramenta de documentação escrita por agentes que sabe quais das próprias frases ficaram desatualizadas, e é isso que faz a documentação gerada valer a pena ser mantida. Damos nota 4.2 de 5.
- Quanto custa OpenWiki?
- Gratuito e de código aberto (MIT). Você paga seu provedor de modelo diretamente.
- Quais são as desvantagens de OpenWiki?
- Telemetria ligada por padrão; o visualizador exige uma CDN pública, então não há visualização offline; o grounding de afirmações cobre só código, não conectores; antes da 1.0, com cerca de 208 issues e PRs abertos.
- Para quem OpenWiki é indicado?
- Equipes cujos agentes de programação vivem redescobrindo o mesmo código e que querem uma wiki que se atualiza em pull requests em vez de ficar defasada.
- Quanto custa OpenWiki para uma equipe ou em produção?
- Software gratuito. A primeira geração de um repositório grande é a etapa cara; execuções nativas podem documentar até 8 páginas em paralelo, e atualizações posteriores só pagam pelas páginas cujas evidências mudaram. Por um agente host, o custo fica dentro dessa assinatura.
- OpenWiki é seguro para dados da empresa?
- A wiki e as afirmações são arquivos comuns no seu repositório; as chaves ficam em ~/.openwiki/.env. A telemetria envia um evento anônimo por init ou update por padrão; OPENWIKI_TELEMETRY_DISABLED=1 desativa. O conteúdo do repositório vai para o provedor de modelo ou agente host que você usar. Licença MIT.
- Quais são as melhores alternativas ao OpenWiki?
- As alternativas mais próximas que analisamos são Repomix, Graphify, code2prompt e claude-mem.
Respostas verificadas em 31 de out. de 2026.