Uma semana atrás, integrei formalmente o Hermes Agent ao meu vault do Obsidian e me lancei um desafio: deixar que ele cuidasse de todo o trabalho com notas automaticamente por sete dias. O resultado me surpreendeu — não porque economizou meu tempo, mas porque meu vault se sentiu vivo pela primeira vez. O briefing matinal estava pronto quando acordei, a caixa de entrada se esvaziava sozinha todas as noites e, o mais impressionante, um grafo semântico desenhado automaticamente colocou na minha frente conexões que eu nunca tinha tornado explícitas. Este é o registro completo da semana, incluindo os dois caminhos oficiais de integração — e um aviso: o comando hermes memory setup --provider obsidian que circula nas comunidades chinesas não existe no código-fonte oficial. Não copie.

Os Dois Caminhos Oficiais

Caminho A: a skill obsidian oficial embutida (ler/escrever notas)

O Hermes já vem com uma skill obsidian de fábrica (categoria note-taking, por Teknium). Ela trata seu vault como um workspace com o filesystem em primeiro lugar: ler notas, listá-las, busca de texto completo, criar notas, anexar conteúdo, edições pontuais e adicionar wikilinks — tudo pelas ferramentas oficiais de arquivo, sem desvio por MCP.

• O caminho do vault é configurado pela variável de ambiente OBSIDIAN_VAULT_PATH (o padrão é ~/Documents/Obsidian Vault quando não definida);
• Caminhos com espaços funcionam normalmente (as ferramentas de arquivo lidam com isso nativamente);
• Notas novas se conectam umas às outras com a sintaxe [[Note Name]] — a alma do Obsidian, e a skill trata isso como regra.

Uso em uma linha: defina OBSIDIAN_VAULT_PATH no seu .env e depois basta dizer ao Hermes “leia a nota diária de hoje” ou “salve isto como uma nota e conecte-a aos tópicos relacionados”.

Caminho B: o plugin da comunidade Obsidian (vault como diretório de trabalho)

Um passo além da skill está o plugin da comunidade Hermes Agent (jsun2020/hermes-agent-obsidian-plugin, MIT). Ele transforma o Obsidian num frontend para o Hermes:

• Chat lateral com múltiplas abas: um painel de conversa embutido no Obsidian, usando o Runs transport do gateway (streams de eventos de tools e raciocínio) com Chat Completions como fallback;
• Contexto com um clique: envie a nota atual ou uma seleção diretamente ao Hermes — sem copiar e colar;
• Vault como diretório de trabalho: defina uma pasta de trabalho e o agente consegue de verdade ler, escrever, buscar e executar fluxos de trabalho multi-etapa sobre suas notas — foi isso que tornou “uma semana de automação” possível;
• Smart Graph: o Hermes lê os resumos das notas e revela conexões semânticas (tópicos compartilhados, uma nota que elabora outra, pré-requisitos/dependências, contradições), renderizadas como um grafo interativo force-directed — a Graph View nativa do Obsidian só conhece [[wikilinks]] explícitos; o Smart Graph encontra as conexões que você sentia mas nunca escreveu. Os resultados ficam em cache, então o grafo sobrevive a reabrir o app.

A autenticação usa o API_SERVER_KEY do gateway (gerado automaticamente pelo Hermes Desktop, em ~/.hermes/.env). A instalação é pelo plugin da comunidade BRAT, ou manualmente com o trio main.js / manifest.json / styles.css.

A Semana, Dia a Dia

• 6h30 toda manhã: um cron job dispara; o Hermes lê a nota diária de ontem e o overview.md de cada projeto, e escreve “o que importa hoje + status de uma linha de cada projeto + loops em aberto” em 04 - HERMES-OUTPUTS/briefings/ — cinco minutos de leitura antes de qualquer notificação, e ainda ganha do noticiário.
• 20h toda noite: o processador da caixa de entrada classifica o que foi despejado em 00 - INBOX/, arquiva e obriga toda nota permanente nova a carregar pelo menos um wikilink — sem conexões, sem pasta permanente. Em uma semana, a caixa de entrada nunca acumulou fila.
• A qualquer momento: selecione um bom artigo, envie para o chat lateral, “leia isto e transforme numa nota de literatura” — ele devolve com fontes e links anexados.
• Surpresa de fim de semana: rodei o Smart Graph e ele conectou uma nota sobre meu fluxo de escrita de três meses atrás às notas de projeto desta semana — eu não fazia ideia de que estavam relacionadas. Essa conexão virou a semente do meu próximo artigo.

Armadilhas Que Encontrei (registro honesto)

1. Sandbox somente leitura do Codex / gpt-5.5: com modelos da família OpenAI-Codex, o agente roda num sandbox somente leitura, então leituras do caminho do vault são rejeitadas (“duas solicitações de permissão somente leitura foram rejeitadas”). Solução: em ~/.codex/config.toml, defina sandbox_mode = "workspace-write" e adicione seu vault a [sandbox_workspace_write].writable_roots; depois reinicie o Hermes Desktop (o gateway carrega a configuração na inicialização). Ambientes Windows com lockdown podem exigir danger-full-access quando o sandbox nem consegue iniciar.
2. O TUI não é o gateway: o plugin conversa com o gateway HTTP (padrão 127.0.0.1:8642); rodar só o chat do TUI não basta — o hermes gateway ou o Hermes Desktop precisa estar de pé.
3. Perfis nomeados mudam a porta: com perfis nomeados o gateway faz bind nas portas 8643–8742; basta atualizar a base URL nas configurações do plugin.
4. Não use o comando falso: hermes memory setup --provider obsidian não existe no código-fonte oficial — o Obsidian não é um provedor de memória; é um workspace para a skill + o plugin.

Início Rápido (Os Dois Caminhos)

# Caminho A: skill oficial (ler/escrever notas)
echo "OBSIDIAN_VAULT_PATH=$HOME/Documents/Obsidian Vault" >> ~/.hermes/.env
# Depois, no chat: /skill obsidian, ou apenas "use a skill obsidian para ler minha nota diária"

# Caminho B: plugin (vault como diretório de trabalho)
# 1. No Obsidian, instale o BRAT → adicione https://github.com/jsun2020/hermes-agent-obsidian-plugin
# 2. Nas configurações, preencha a URL do gateway (padrão http://127.0.0.1:8642) + API_SERVER_KEY
# 3. Clique em Test connection e abra o chat lateral

Para agendamento (briefings matinais, processamento da caixa de entrada) o cron do Hermes faz a orquestração — veja o guia completo de automação com cron. Para isolar vaults por perfil: múltiplas instâncias independentes numa única máquina. O post anterior sobre transformar conversas em notas cobre o pipeline de captura unidirecional; este aqui é o workspace bidirecional — eles se complementam.

Conclusão

Depois de uma semana de “automação total”, meu maior aprendizado: Obsidian e Hermes formam um par natural — o Obsidian fornece a camada de conhecimento legível por humanos, permanente e conectável; o Hermes fornece a camada cerebral que pensa, lembra e executa tarefas agendadas. A skill oficial cuida da leitura/escrita, o plugin da comunidade cuida da colaboração bidirecional e da descoberta semântica, e o cron cuida dos horários. Ignore os comandos fabricados que circulam nos fóruns chineses; siga os dois caminhos oficiais e seu vault vai se sentir vivo em uma semana também.