Moxie Docs
jackalope.digital · Programação
O Moxie Docs é um serviço hospedado de documentação para repositórios do GitHub. Você conecta um repositório, ele indexa seu código numa base de conhecimento pesquisável, mantém essa base sincronizada a cada merge e entrega o mesmo contexto aos agentes de código com IA via MCP. Ele também roda verificações em cada PR que apontam lacunas na documentação e abre PRs de limpeza toda sexta-feira, para que a wiki não apodreça em silêncio. E por que se dar ao trabalho de usar documentação de código automatizada? Porque a manual sempre perde.
Sobre Moxie Docs
O que é o Moxie Docs
O Moxie Docs é documentação de código automatizada para equipes que publicam no GitHub. Ele lê seu repositório, escreve documentação com citação das fontes sobre como o código realmente funciona e mantém esses documentos em dia conforme o código muda. Em vez de uma wiki estática que ninguém atualiza, você tem um conjunto vivo de documentos que é revisado toda vez que você faz merge. Essa é a proposta, e pelo que mostram as páginas do produto, ela se sustenta razoavelmente bem.
A ideia mais ambiciosa é o contexto para agentes de IA. Agentes de código como Cursor, Claude Code, Codex e Windsurf fazem edições piores quando precisam adivinhar suas convenções e sua arquitetura. O Moxie Docs expõe a documentação, as convenções e as lacunas do seu repositório pelo Model Context Protocol, então o agente puxa um contexto compacto e preciso em vez de gastar tokens lendo arquivos às cegas. Um comando de configuração depois de conectar o GitHub e pronto. Sem empacotar contexto à mão.
Os limites também importam. Só funciona com GitHub, então se sua equipe vive no GitLab ou no Bitbucket, isso não é para você. É um serviço hospedado, o que significa que seu código e seus documentos ficam na infraestrutura de outra pessoa, algo que algumas equipes simplesmente não aceitam. E o preço além do plano gratuito não está publicado com clareza, então quem cuida do orçamento deve confirmar os custos com o fornecedor antes de se comprometer.
Como começar
- Cadastre-se em moxiedocs.com com sua conta do GitHub. O plano gratuito cobre um repositório e não pede cartão.
- Conecte o repositório que você quer documentar e conceda acesso de leitura para que o serviço possa indexá-lo.
- Deixe a primeira indexação terminar. O Moxie Docs gera notas de arquitetura, limites entre módulos e fluxos entre arquivos com diagramas Mermaid, tudo citado de volta à fonte.
- Ligue o servidor MCP ao seu agente de código com o comando de configuração fornecido, para que os agentes consultem a documentação ao vivo em vez de adivinhar.
- Ative as verificações em cada PR e, se quiser, torne-as obrigatórias na proteção de branches, para que as lacunas de documentação sejam apontadas em cada pull request.
Informações do produto
Uma visão rápida dos preços, das plataformas compatíveis e do desempenho de Moxie Docs.
Ideal para
Os usuários, tarefas e cenários em que esta ferramenta se encaixa melhor.
Usuários
- Engenheiros de backend e de plataforma
- Equipes de engenharia que integram gente nova
- Desenvolvedores que usam agentes de código com IA
Tarefas
- Gerar documentação do código
- Manter a documentação em sincronia com o código
- Alimentar agentes de IA com o contexto do repositório
- Auditar a documentação nos pull requests
Cenários
- Um repositório que anda rápido, onde o README ficou desatualizado meses atrás e ninguém notou
- Integrar um engenheiro novo que precisa se situar rápido
- Uma equipe que já usa agentes de código com IA e que vivem errando as convenções do projeto.
- Manutenção semanal da documentação
Principais recursos
Documentação de código automatizada
O Moxie Docs indexa seu repositório do GitHub e escreve documentação de código automatizada e pesquisável que cobre arquitetura, limites entre módulos, convenções e fluxos entre arquivos. Cada afirmação cita o arquivo de origem de onde veio, então você pode verificar em vez de confiar. Os documentos são revisados a cada merge em vez de escritos uma vez e esquecidos.
Contexto MCP para agentes de código com IA
O serviço expõe a documentação, as convenções e as lacunas abertas do seu repositório pelo Model Context Protocol. Agentes como Cursor, Claude Code, Codex e Windsurf podem então puxar contexto compacto em vez de fazer leituras exploratórias, o que significa menos tokens desperdiçados e edições que respeitam como seu projeto é realmente construído. A configuração é um comando só depois de conectar o GitHub.
Detecção de desvio na documentação
Como os documentos são checados a cada merge, o Moxie Docs pode apontar o momento em que eles saem de compasso com o código. Em vez de uma wiki que apodrece em silêncio, você recebe um sinal de que um documento específico já não bate com o que foi publicado. É a diferença entre notar o desvio numa sexta-feira e notar seis meses depois. É nessa lacuna que a confiança na documentação morre.
Verificações de documentação em cada PR
Em cada pull request, o Moxie Docs roda uma verificação informativa que aponta lacunas de documentação, quebras de convenção e descrições de PR que pulam seu template. Você pode deixá-la informativa ou exigi-la na proteção de branches quando quiser uma barreira firme. As equipes que tratam a documentação como parte da definição de pronto são as que mais aproveitam.
PRs de limpeza de sexta-feira
Toda semana o serviço pode abrir um pull request que agrupa correções de documentação geradas a partir da atividade no GitHub. Você revisa como qualquer outro PR, fica com o que é bom e descarta o que não é. Transforma a tarefa vaga de "atualizar os documentos" numa mudança concreta e revisável.
Bases de conhecimento públicas hospedadas
O Moxie Docs hospeda bases de conhecimento públicas, o que cai bem em projetos de código aberto que querem a documentação visível sem manter à mão um site de docs. Também é um jeito limpo de publicar notas de arquitetura para colaboradores externos.
Prós e contras
Prós
- Os documentos citam a fonte, então você pode conferir as afirmações em vez de confiar nelas
- A documentação viva é revisada a cada merge, que é justamente onde quase toda wiki falha
- O contexto MCP reduz as leituras exploratórias dos agentes de IA, economiza tokens e melhora as edições
- O plano gratuito cobre um repositório sem cartão, pouco risco para testar
- Os PRs de limpeza de sexta-feira transformam a manutenção da documentação num fluxo de revisão normal
Contras
- Só GitHub, então equipes no GitLab e no Bitbucket não podem usar
- É um serviço hospedado, então seu código e seus documentos ficam em infraestrutura de terceiros, algo que algumas equipes não permitem
- O preço além do plano gratuito não está publicado com clareza, então você terá que perguntar antes de orçar
- Ele documenta o que seu código faz, não se o design é bom, então não substitui a revisão de arquitetura
Perguntas frequentes
Ele se conecta ao seu repositório do GitHub, gera documentação com citação das fontes sobre o código, mantém tudo em dia a cada merge e entrega esse contexto aos agentes de código com IA via MCP. Pense nele como documentação automatizada e sempre fresca, com uma API amigável para agentes por cima.
Conteúdo relacionado
Explore ferramentas, skills e artigos relacionados a Moxie Docs.
Alternativas a Moxie Docs
Forefront
Forefront · ProgramaçãoO Forefront é uma plataforma web para construir com IA de código aberto. Você ajusta os principais modelos de linguagem de código aberto com seus próprios dados, avalia o desempenho deles e os roda por uma API ou os exporta para hospedar por conta própria. Desenvolvedores que querem a conveniência de uma plataforma fechada, mas fazem questão de ser donos dos modelos e dos dados, são o público-alvo aqui.
Startkit
StartKit.AI · ProgramaçãoStartkit é um boilerplate para criar produtos de SaaS com IA e wrappers de IA. Pense nele como um boilerplate para startups de IA com as partes chatas já conectadas: autenticação, pagamentos com Stripe e Lemon Squeezy, limites de uso, e-mail transacional e um kit inicial de API de IA que conversa com OpenAI, Anthropic, Groq ou Llama. Você clona o repositório, define seu preço e começa pela parte do produto que as pessoas realmente pagam. Ele é feito em Next.js sobre React e Tailwind, então boa parte do código boilerplate já parece familiar.
Testim
Tricentis · ProgramaçãoO Testim é uma plataforma de automação de testes com IA para criar e executar testes de ponta a ponta em aplicações web, mobile e Salesforce. Ele se apoia no aprendizado de máquina para manter os testes estáveis quando uma interface muda, então as equipes gastam menos tempo consertando seletores quebrados. Nada mal para uma ferramenta de testes automatizados que você pode começar a usar hoje. Você cria testes gravando ações no navegador e depois adiciona JavaScript quando precisa de mais controle. É uma escolha sólida para equipes de QA ocupadas.