Second Brain OS: monte uma base de conhecimento que se organiza sozinha com o Claude Code

Para quem é

• Ideal para quem quer usar o Claude Code para montar uma base de conhecimento que se organiza sozinha: você coleta artigos e notas e quer que eles sejam extraídos automaticamente, conectados entre si e mantidos organizados, em vez de virarem um monte de arquivos que ninguém relê.
• O projeto oferece um guia completo, um vault inicial, agent skills e scripts, funcionando em torno de arquivos markdown, wikilinks e SKILL.md; também serve para qualquer agente que saiba ler arquivos. O Obsidian é apenas um visualizador de grafo, não uma dependência.
• Quando não é adequado: se você quer um software de notas gráfico pronto para usar, sem estar disposto a clonar repositórios, copiar diretórios e executar agentes no terminal, esse fluxo não serve. A evidência oficial não informa quais clientes além dos agentes específicos são suportados, quais idiomas de texto são aceitos, nem se existem restrições além de pagamento ou conta — é gratuito e sem registro, mas os demais limites são desconhecidos.

Primeira tentativa em 3 minutos

O caminho principal oficial é instalar localmente em ~/brain pelo terminal e, em seguida, iniciar o Claude Code nesse diretório:

1. Pré-requisitos: ter git e o Claude Code (o agente) instalados; recomenda-se também instalar o Obsidian para visualizar o grafo.
2. No terminal, execute os comandos de instalação oficiais, copiando o vault inicial junto com skills, commands e agents para ~/brain/.claude:

git clone https://github.com/undefined-ui/second-brain-os.git
cp -r second-brain-os/vault-template ~/brain

mkdir -p ~/brain/.claude
cp -r second-brain-os/skills   ~/brain/.claude/skills
cp -r second-brain-os/commands ~/brain/.claude/commands
cp -r second-brain-os/agents   ~/brain/.claude/agents

cd ~/brain && claude

1. Efeitos colaterais e pontos de verificação: os comandos acima criam ~/brain no seu diretório de usuário e escrevem arquivos nele; se o destino já existir, confirme você mesmo antes de sobrescrever.
2. Dispare uma primeira tarefa de baixo risco: salve/recorte um artigo como arquivo no diretório raw/ e digite /ingest no Claude Code. Esse é o fluxo de trabalho central oficial: o agente ingere o material, extrai pontos, cria links e limpa o conteúdo bruto, organizando-o em um wiki interligado. Ele lê e escreve arquivos markdown dentro do vault; se executa comandos ou acessa a rede, a evidência oficial não diz — trate como desconhecido. Se o artigo contiver conteúdo sensível, anonimize-o antes de colocá-lo em raw/.
3. Sinal de sucesso: os artigos em raw/ são transformados em páginas de notas com wikilinks dentro do vault; a regra oficial é "Nothing is ingested until it is linked" — se os links não forem concluídos na mesma rodada, a ingestão não terminou. Portanto, verifique se as novas páginas realmente contêm links apontando para outras notas; esse é o critério para determinar que a rodada de /ingest foi concluída. A evidência oficial não informa quais etapas de verificação o /ingest executa internamente, nem se há fluxos diferentes para tipos de texto distintos; não presuma nada disso.

Casos de uso

Caso 1: arquivamento de artigos coletados. Você recorta artigos no navegador, mas nunca os relê. Cenário: salve um artigo recortado em ~/brain/raw/ e execute /ingest no Claude Code. Ele segue o fluxo oficial de ingestão — extrai pontos-chave, conecta às notas existentes e limpa. Resultado esperado: os arquivos brutos são convertidos em páginas de wiki interligadas; se você notar que a nova página está sem links, pela regra oficial a ingestão da rodada é considerada incompleta e você pode pedir ao agente para completar os links.

Caso 2: visualizar o grafo de conhecimento no Obsidian. Cenário: depois de algumas ingestões, você quer confirmar as conexões entre as notas. Como fazer: abra o vault ~/brain no Obsidian (o Obsidian é o visualizador de grafo indicado oficialmente) e explore o grafo formado pelas notas e wikilinks. O que pode ser confirmado: o vault é puro markdown e wikilinks, e o Obsidian abre e exibe o grafo diretamente; a documentação oficial não menciona integrações ou sincronizações automáticas mais profundas, portanto não espere nada além da função de visualizador.

Limites de uso

• Acesso a arquivos: a instalação e a execução criam e modificam arquivos markdown localmente (~/brain, raw/, diretório .claude); isso é o núcleo do fluxo, não um efeito colateral opcional.
• Comandos e rede: a evidência oficial traz apenas os comandos shell de instalação acima; se o agente executa outros comandos ou acessa a rede durante a ingestão, não foi informado — trata-se de desconhecido.
• Pontos de verificação: revise você mesmo materiais sensíveis antes de colocá-los em raw/; confirme antes de sobrescrever um ~/brain existente.
• Ambiente de execução: requer um terminal local, git e um agente que leia arquivos (o caminho principal oficial usa o Claude Code); o Obsidian é necessário para ver a visão de grafo, mas não é uma dependência. Além disso, a documentação oficial não lista outras restrições de execução.
• Informações-chave não confirmadas: se a lista de agentes suportados se limita ao Claude Code (o oficial diz apenas que "works with Claude Code and any agent that reads files"), quais idiomas de texto são suportados e quais outros comandos existem além do /ingest — nada disso tem evidência; antes de usar, você pode inspecionar os arquivos reais nos diretórios skills e commands para confirmar.