Sincronização com o Obsidian

Mantenha suas notas no Obsidian.
Seus agentes também as leem e escrevem.

Vincule uma pasta do seu cofre do Obsidian a um projeto. O que você escreve no Obsidian vira a memória que seus agentes de código de IA leem antes de começar, e o que eles aprendem volta ao cofre em Markdown, com os [[links]] intactos.

Nenhum plugin para instalar no Obsidian, nenhuma assinatura do Obsidian Sync, nenhum agente para rodar dentro do cofre. O AgentsRoom observa a pasta no disco enquanto o aplicativo para computador estiver em execução e conectado à internet, e as mesmas notas chegam ao Claude Code, ao Codex, ao GitHub Copilot CLI ou a qualquer outra CLI de agente que você iniciar no projeto.

Uma sessão real, gravada no app: a Sincronização com o Obsidian, na memória do projeto, vincula uma pasta de um cofre do Obsidian nos dois sentidos. As duas notas do cofre chegam à memória com suas descrições e tags. Um agente a quem se pede uma função de preços consulta primeiro a memória e segue a regra de preços escrita no Obsidian. Quando se pede que ele salve o que aprendeu, ele acrescenta uma seção a essa nota, que volta à pasta do cofre em Markdown, com os links intactos.

Assistir no YouTube

Uma pasta, uma memória, todos os agentes
Pasta do cofre
architecture.md
auth-decisions.md
release-runbook.md
Memória do projeto
architecture.md
auth-decisions.md
release-runbook.md
Agentes
Claude Code
Codex
GitHub Copilot CLI
Conflito: você escolhe

Uma nota editada no Obsidian chega à memória, uma nota salva por um agente chega ao cofre. Duas edições da mesma nota esperam por você.

Muitos desenvolvedores já guardam suas ideias no Obsidian: notas de arquitetura, decisões, um guia de procedimentos, os motivos pelos quais um módulo é construído de determinado jeito. O Claude Code e as outras CLIs de agente começam cada sessão sem nada disso, a menos que você cole o conteúdo ou rode o agente dentro do cofre.

O AgentsRoom já dá a cada projeto uma memória que seus agentes leem antes de explorar o código e na qual escrevem enquanto trabalham. A sincronização com o Obsidian conecta as duas coisas. Você escolhe uma pasta do seu cofre, e as notas Markdown dela viram notas da memória desse projeto. No outro sentido, as notas que seus agentes salvam são gravadas de volta na pasta, com metadados iniciais (frontmatter) e [[wiki-links]], então o Obsidian continua sendo o seu editor e o seu grafo.

É uma sincronização, não uma importação pontual, e ela nunca resolve um desacordo por você. Quando a mesma nota muda dos dois lados entre duas rodadas, ou é excluída de um lado, as duas versões são mantidas e a nota espera até você escolher. Todas as outras notas continuam circulando.

O que a sincronização com o Obsidian faz

Uma pasta do seu cofre, um projeto, as mesmas notas para cada agente.

Nos dois sentidos

As edições feitas no Obsidian atualizam a memória do projeto. As notas criadas ou alteradas pelos agentes são gravadas na pasta em Markdown, e as notas que já estão na memória também são exportadas para lá.

Ou apenas do cofre para a memória

Prefere que nada toque no seu cofre? Este modo só lê a pasta. Os agentes continuam lendo suas notas, mas nada do que eles escrevem chega ao Obsidian.

Os conflitos esperam por você

Nada de «o último a escrever vence». Duas edições da mesma nota, ou uma edição contra uma exclusão, param só aquela nota e mostram as duas versões, a do Obsidian e a da memória. Você escolhe qual manter.

Links e propriedades mantidos

Os links [[note#heading|alias]], o corpo Markdown e as propriedades YAML que você adicionou ficam como estão. As notas escritas pelos agentes trazem uma descrição e tags nos metadados iniciais (frontmatter).

Todas as CLIs de agente

As notas viram notas de memória comuns, que o Claude, o Codex, o GitHub Copilot CLI, o Cursor e as outras 10 CLIs de agente suportadas pelo AgentsRoom leem com as mesmas ferramentas de memória.

Vários computadores

O vínculo pertence à sua conta. Em outro computador, o projeto o mostra e pede que você localize lá a pasta correspondente do cofre. Desvincular interrompe a sincronização em todos os computadores.

Barra de ferramentas da janela de memória do AgentsRoom: Graph view, Import from Obsidian, Obsidian sync, Import from project e New memory, acima do aviso de que a memória é armazenada no servidor e compartilhada com todos que abrem o projeto
Onde fica: Sincronização com o Obsidian está na barra de ferramentas da memória do projeto, ao lado da importação pontual Importar do Obsidian.

Como funciona

Quatro passos. Os três primeiros acontecem uma vez por projeto.

  1. 1

    Abra a memória do projeto

    No projeto, abra Memória do projeto pelo dock (o ícone do cérebro). Na barra de ferramentas dela, clique em Sincronização com o Obsidian.

  2. 2

    Escolha uma pasta do cofre

    Clique em Escolher uma pasta do cofre e selecione seu cofre ou uma das subpastas dele. Uma pasta de projeto com algumas centenas de notas é mais adequada que o cofre inteiro: cada nota dentro dela será compartilhada com o projeto.

  3. 3

    Escolha uma direção e vincule

    Em Direção da sincronização, escolha Nos dois sentidos ou Apenas do cofre para a memória, leia o aviso sobre o compartilhamento e clique em Vincular esta pasta. A primeira rodada começa na hora.

  4. 4

    Escreva, e deixe os agentes escreverem

    Continue editando no Obsidian. O AgentsRoom detecta os arquivos salvos em poucos segundos e verifica a memória a cada 30 segundos, sem que o painel esteja aberto. Sincronizar agora força uma rodada; Conflitos a resolver lista as notas que aguardam sua escolha.

Painel Obsidian sync do AgentsRoom antes de vincular uma pasta: o aviso de que cada nota Markdown da pasta é compartilhada com o projeto, o botão Choose a vault folder, o menu Sync direction em Both ways e o botão Link this folder
O painel Sincronização com o Obsidian: escolha uma pasta do cofre, uma direção (Nos dois sentidos ou Apenas do cofre para a memória), leia o aviso sobre o compartilhamento e depois vincule a pasta.

O que o Obsidian e as CLIs de agente já fazem sozinhos

Você não precisa do AgentsRoom para colocar um agente para trabalhar nas suas notas. O jeito mais simples é iniciar o Claude Code ou o Codex dentro da pasta do cofre: as notas são arquivos Markdown, e o agente as lê e edita como se fossem código. Plugins da comunidade vão além e levam o agente para dentro do próprio Obsidian. O Claudian, por exemplo, abre o Claude Code, o Codex, o OpenCode e outros agentes em uma barra lateral, com o cofre como diretório de trabalho.

Também existem pontes para um agente que trabalha em outro lugar. Servidores MCP como o mcp-obsidian expõem o cofre por meio do plugin comunitário Local REST API, o que significa que o Obsidian precisa estar aberto. Desde a versão 1.12, o Obsidian traz sua própria linha de comando (Settings, General, Command line interface) com comandos como read, search, create e append, e ela também se comunica com o aplicativo em execução.

A sincronização com o Obsidian atende a outra necessidade. Seus agentes trabalham em um repositório de código, não no cofre, e você quer que as notas importantes para esse projeto façam parte do que cada agente lê antes de começar, em cada computador e para cada colega do projeto. A sincronização lê e grava os arquivos no disco, então o Obsidian não precisa estar aberto, e ela guarda o conflito para você em vez de deixar o último a escrever vencer. Ela funciona junto com qualquer uma das soluções acima.

O que saber

  • A sincronização roda enquanto o aplicativo para computador do AgentsRoom estiver em execução e conectado à internet. As edições feitas no Obsidian enquanto ele estiver fechado são captadas na rodada seguinte.
  • Cada nota Markdown da pasta vinculada é compartilhada com todos que têm acesso à memória do projeto, e a memória é armazenada nos servidores do AgentsRoom. Vincule uma pasta de projeto, não um cofre cheio de notas pessoais, e não coloque segredos nela.
  • Até 2.000 notas, 1 MB por nota e 16 MB no total, oito níveis de subpastas. Anexos, pastas ocultas e links simbólicos ficam de fora.
  • Uma pasta do cofre por projeto. Uma pasta não pode se sobrepor à pasta vinculada a outro projeto.
  • Quando um agente renomeia ou move uma nota da memória, o arquivo mantém seu caminho no cofre, então seus links não quebram. Uma nota renomeada e editada no Obsidian entre duas rodadas pode voltar como uma nota nova mais uma exclusão a confirmar: nada é excluído sem a sua escolha.
  • Vincular uma pasta e resolver conflitos acontece no aplicativo para computador. Os agentes que você controla pelo app móvel leem as mesmas notas.

Perguntas frequentes

O Claude Code consegue ler meu cofre do Obsidian?

Sim, as notas da pasta que você vincular. Elas viram notas da memória do projeto, e cada agente que você inicia no projeto, incluindo o Claude Code, recebe a instrução de consultar essa memória antes de explorar o código. O agente não precisa rodar dentro do cofre, e o Obsidian não precisa estar aberto.

Meus agentes vão escrever no meu cofre?

Só se você escolher Nos dois sentidos. Nesse caso, as notas que eles criam ou alteram são gravadas na pasta vinculada em Markdown, com uma descrição e tags nos metadados iniciais (frontmatter) e os [[links]] mantidos. Com Apenas do cofre para a memória, nada é gravado no cofre.

O que acontece se eu editar uma nota no Obsidian enquanto um agente a altera?

Essa nota para e mostra as duas versões, a versão do Obsidian e a versão da memória do projeto, até você escolher uma. Uma exclusão de um lado também aguarda sua escolha. As outras notas continuam sincronizando. Se alguma das versões mudar de novo antes da sua decisão, você revisa primeiro o conflito atualizado.

Preciso de um plugin do Obsidian, do Obsidian Sync ou da Local REST API?

Não. O AgentsRoom lê e grava os arquivos Markdown da pasta diretamente no disco. Nada é instalado no Obsidian, o aplicativo não precisa estar aberto e a sincronização não usa o Obsidian Sync. Ela precisa, sim, do aplicativo para computador do AgentsRoom em execução e conectado à internet.

Quais CLIs de agente podem usar as notas do meu cofre?

Todas as 14 CLIs de agente que o AgentsRoom suporta (Claude, Codex, GitHub Copilot CLI, Cursor e outras 10). As notas do cofre são notas de memória comuns, lidas pelas mesmas ferramentas de memória que as notas que os próprios agentes escreveram.

Quem pode ver as notas da pasta vinculada?

Todos que têm acesso à memória do projeto, que é compartilhada com todos que trabalham no projeto e armazenada nos servidores do AgentsRoom. Por isso você escolhe a pasta explicitamente e o painel avisa antes de vincular. Vincule a pasta que pertence ao projeto, não o cofre inteiro, e nunca coloque senhas ou chaves nela.

Funciona em vários computadores?

Sim. O vínculo fica salvo na sua conta. Em um segundo computador, o projeto o mostra e pede que você localize a pasta correspondente do cofre nessa máquina, já que o caminho muda de um computador para outro. Desvincular interrompe a sincronização em todos os lugares e mantém as notas e os arquivos onde estão.

Qual é a diferença em relação a Importar do Obsidian?

Importar do Obsidian copia notas para a memória uma única vez, e você escolhe quais. Sincronização com o Obsidian mantém, a partir daí, uma pasta e a memória sincronizadas, nos dois sentidos ou apenas a partir do cofre, e cuida dos conflitos. Os dois botões ficam na barra de ferramentas da memória do projeto.

Para se aprofundar

Você também pode gostar

Dê aos seus agentes as notas que você já mantém

Vincule uma pasta do cofre a um projeto e deixe o Claude Code, o Codex e todas as CLIs de agente partirem do que você já escreveu.

GrátisBaixar AgentsRoom

App complementar: acompanhe seus agentes em qualquer lugar

Use Claude, Codex, Antigravity CLI ou outro provedor de IA.

Instalar a extensão
Chrome Web Store

Envie bugs e pedidos direto para o seu backlog público.

Multi-projetos
Multi-provedor
Multi-agentes
Status ao vivo
Diff e commit
App mobile
Preview ao vivo
Equipes de agentes
Testes no navegador
Dev guiada por backlog
Biblioteca de prompts
Biblioteca de skills
Ver todas as funcionalidades