OpenWiki — CLI para criar e gerenciar documentação para agentes em bases de código

 (github.com/langchain-ai)
14 pontos por xguru 1 일 전 | 3 comentários | Compartilhar no WhatsApp
  • Ferramenta de documentação criada especificamente para agentes, para criar/manter wikis para bases de código ou memória por objetivo
  • Importa fontes locais de conhecimento por meio de conectores integrados ou repositórios Git e as consolida em uma única wiki local
  • Oferece dois modos
    • Modo Personal: cria uma wiki pessoal do seu cérebro em ~/.openwiki/wiki, usando como fontes repositórios locais, Gmail, Notion, Web Search, Hacker News, X etc.
    • Modo Code: gera documentação do repositório para a base de código atual em openwiki/
  • Atualização automática da documentação via integração com CI, com exemplos de workflows para GitHub Actions/GitLab CI que criam automaticamente PRs/merge requests de atualização da documentação
  • Gera bundles no Google Open Knowledge Format (OKF) v0.1 em ambos os modos; documentos conceituais têm YAML front matter com o campo type e expressam relações por links Markdown
  • A cada execução em modo code, mantém AGENTS.md e CLAUDE.md na raiz do repositório, orientando agentes de programação a consultar a wiki ao buscar contexto
    • Se os arquivos já existirem, atualiza apenas o bloco <!-- OPENWIKI:START -->…<!-- OPENWIKI:END --> e preserva o restante
  • Suporta coleta por conectores locais para repositórios Git, Notion, Gmail, X, Web Search e Hacker News; o mesmo conector pode ser configurado em múltiplas instâncias
  • Suporte a diversos provedores de inferência: OpenAI, OpenRouter, Gemini (AI Studio), Gemini Enterprise (Vertex AI), Nebius Token Factory, Fireworks, Baseten, NVIDIA NIM, compatíveis com OpenAI, AWS Bedrock e Anthropic
    • O padrão no onboarding é gpt-5.6-terra da OpenAI; oferece métodos de autenticação específicos por provedor, como login do ChatGPT, credenciais IAM e Google ADC
  • Coleta telemetria anônima por padrão (nível de comando/resultado/provedor/nome do conector), mas não coleta conteúdo de arquivos/credenciais/prompts/saída de modelo/IP; pode ser desativada com OPENWIKI_TELEMETRY_DISABLED=1 ou DO_NOT_TRACK=1
  • Instalação com npm install -g openwiki
  • Licença MIT

Leituras relacionadas

3 comentários

 
laeyoung 1 일 전

Eu estava pensando em testar, mas a parte de coletar telemetria anônima por padrão (no nível de comandos/resultados/nomes de provedores/conectores) é um pouco decepcionante. Dizem que dá para desativar, mas parece que muita gente não lê direito e simplesmente usa a configuração padrão.
 
superl3 23 시간 전

Pode ser desativado com OPENWIKI_TELEMETRY_DISABLED=1 ou DO_NOT_TRACK=1
mas você não confia nisso?
 
laeyoung 20 시간 전

Dá para desativar, mas como o padrão é opt-in, acho que muita gente vai usar assim por padrão.

Pensando em recomendar para um colega ou amigo, eu diria "OpenWiki é bom, experimenta", não "OpenWiki é bom, mas dá para desativar a coleta de dados com OPENWIKI_TELEMETRY_DISABLED=1 ou DO_NOT_TRACK=1, então use com isso ativado" rs

Mas eu tinha entendido comando e resultado como Prompt e Output. Revendo o original, não era isso. Então talvez esteja tudo bem?!