{
  "markdown": "# Sheldon\n\nTransforme documentos, páginas públicas e repositórios locais em conhecimento que continua útil\ndepois da tarefa de hoje. Sheldon é um segundo cérebro local-first: preserva as fontes, cria uma\nwiki Markdown revisável e permite reutilizar o conhecimento com a CLI, a interface web e agentes\ncompatíveis.\n\n## Por que Sheldon\n\nInformação importante costuma ficar espalhada entre arquivos, páginas, vídeos e histórico de\nprojetos. Repetir esse contexto em cada conversa com um agente é lento, difícil de conferir e não\nconstrói memória durável.\n\nSheldon separa captura, síntese e aprovação:\n\n1. Você captura uma fonte e conserva o original.\n2. A ferramenta normaliza o conteúdo para Markdown e registra a proveniência.\n3. Codex CLI ou Claude Code podem gerar uma proposta de conhecimento.\n4. Você revisa e aprova, arquivo a arquivo, antes de a wiki mudar.\n\nO resultado é uma base de conhecimento legível sem Sheldon, rastreável até suas fontes e pronta\npara servir de contexto a outros projetos.\n\n## O que ele faz\n\n- Organiza conhecimento em tópicos e projetos, guardando fontes, wiki e resultados no seu disco.\n- Importa documentos e dados locais, páginas públicas, crawls pequenos, vídeos públicos do YouTube,\n  posts públicos do Instagram e LinkedIn e snapshots de repositórios Git locais.\n- Oferece busca local, consultas com referências, revisão de propostas e bundles portáteis de\n  conhecimento.\n- Expõe conteúdo aprovado para Codex e Claude por MCP local, com escopo explícito por projeto\n  consumidor.\n- Inclui uma interface web local para acompanhar o vault e os trabalhos em execução.\n\n## Instalação\n\nO pacote público requer Node.js 24 LTS ou superior e oferece suporte para Windows x64, Linux x64 e\nmacOS em processadores Intel ou Apple Silicon.\n\n```powershell\nnpm install --global @oldboydev/sheldon\nsheldon --help\n```\n\nPara atualizar:\n\n```powershell\nnpm update --global @oldboydev/sheldon\n```\n\n## Comece em minutos\n\nCrie seu vault — a pasta que guarda todo o conhecimento:\n\n```powershell\nsheldon init C:\\knowledge\\sheldon\n```\n\nCrie um tópico para reunir conhecimento de um assunto:\n\n```powershell\nsheldon topic create \"Aprendizado\" --vault C:\\knowledge\\sheldon\n```\n\nAbra a interface web local:\n\n```powershell\nsheldon web --vault C:\\knowledge\\sheldon\n```\n\nEla informa uma URL em `http://127.0.0.1:<porta>`. A interface só aceita conexões da própria\nmáquina.\n\nConfira o ambiente quando necessário:\n\n```powershell\nsheldon doctor --vault C:\\knowledge\\sheldon\n```\n\n## Fluxo de trabalho\n\n### 1. Capture uma fonte\n\nOs conectores de fonte são plugins. Confira o que está instalado e o catálogo oficial disponível:\n\n```powershell\nsheldon plugin list\nsheldon plugin list --remote\n```\n\nQuando o conector desejado estiver disponível, instale-o e importe uma fonte. Por exemplo, para um\narquivo local:\n\n```powershell\nsheldon plugin install source.file\nsheldon ingest file topic aprendizado C:\\inbox\\artigo.pdf --vault C:\\knowledge\\sheldon\n```\n\nO comando retorna o identificador da fonte e o caminho do conteúdo normalizado. Para uma página\npública, use `sheldon ingest url`; para um crawl limitado, `sheldon ingest crawl`; para um checkout\nGit local, `sheldon ingest repository`. Execute `sheldon help ingest` para ver todas as opções.\n\n### 2. Transforme conteúdo em proposta\n\nDepois de capturar a fonte, peça uma proposta a um agente já instalado e autenticado. A proposta\nnão altera a wiki automaticamente:\n\n```powershell\nsheldon compile topic aprendizado proposta-artigo `\n  --agent codex `\n  --prompt \"Extraia ideias práticas e crie notas concisas com fontes.\" `\n  --raw raw/<source-id>/content.md `\n  --vault C:\\knowledge\\sheldon\n```\n\nSubstitua `codex` por `claude` se preferir. Use `sheldon agent doctor` para diagnosticar a\ndisponibilidade dos agentes.\n\n### 3. Revise antes de publicar\n\nVeja o que será modificado e aprove somente os arquivos desejados:\n\n```powershell\nsheldon review preview topic aprendizado proposta-artigo --vault C:\\knowledge\\sheldon\nsheldon review approve topic aprendizado proposta-artigo wiki/ideias-praticas.md `\n  --vault C:\\knowledge\\sheldon\n```\n\nAssim, a wiki só recebe mudanças que você conferiu.\n\n### 4. Encontre e reutilize conhecimento\n\nBusque por texto e filtros locais:\n\n```powershell\nsheldon search \"prática de recuperação\" --topic aprendizado --vault C:\\knowledge\\sheldon\n```\n\nPara levar o conhecimento aprovado a outro projeto, configure o MCP local com um escopo explícito:\n\n```powershell\nsheldon mcp configure C:\\src\\app-consumidor `\n  --vault C:\\knowledge\\sheldon `\n  --consumer-id app-consumidor `\n  --scope topic:aprendizado\n```\n\nO comando mostra uma prévia antes de escrever configurações do cliente. Acrescente `--apply` após\nrevisar essa prévia.\n\n## Privacidade e controle\n\nSeu vault é composto por arquivos locais. Fontes originais, conteúdo normalizado, propostas e wiki\npermanecem sob seu controle. SQLite é usado apenas para estado operacional e índices\nreconstruíveis, não como fonte de verdade do conhecimento.\n\nA interface web usa loopback (`127.0.0.1`) e o MCP usa `stdio`; nenhum deles abre acesso na rede.\nSheldon não chama APIs de modelos diretamente. Codex CLI e Claude Code são integrações opcionais e\nsó recebem contexto quando você inicia uma operação que pede um agente.\n\n## Referência e documentação\n\n- Use `sheldon help` ou `sheldon help <comando>` para a referência completa da CLI.\n- Consulte a [visão do produto](docs/product/vision.md) para princípios e limites.\n- Consulte a [arquitetura](docs/product/architecture.md) para contratos, segurança e componentes.\n- Consulte o [índice de documentação](docs/README.md) para roadmap, decisões, PRDs e notas de\n  implementação.\n- Leia o [guia de contribuição](CONTRIBUTING.md) antes de contribuir com o projeto.\n\n## Projeto\n\nCódigo, issues e contribuições: [github.com/oldboydev/sheldon](https://github.com/oldboydev/sheldon).\n",
  "bytes": 5853,
  "sha": "b96a6d21e6033782df5535d27d3e48c4f7914346ee9e08c3def9414256957bce",
  "repo_slug": "oldboydev/sheldon",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/okf_oldboydev_sheldon_test_fixtures_okf_mini_bdc9a98e/readme"
}