O que obsidian faz?
Use isto para trabalhar com um baú local do Obsidian. Um baú Obsidian é uma pasta normal de arquivos Markdown mais a configuração .obsidian/.
Fontes
- Configuração do app:
~/Library/Application Support/obsidian/obsidian.json - Nome padrão do baú:
obsidian - Caminho local usual do baú:
~/obsidian - CLI oficial:
obsidian - Os comandos do baú resolvem o baú a partir do diretório atual (cwd); execute-os de
~/obsidian.
Primeiras Verificações
command -v obsidian
obsidian version
obsidian vaults
cd ~/obsidian
obsidian commands filter=search:
Comandos globais como version e vaults funcionam fora de um baú. Comandos de conteúdo do baú podem imprimir Vault not found. fora de ~/obsidian. Use obsidian commands, não obsidian help, para descobrir comandos da CLI.
Se o obsidian disser que a CLI está desabilitada:
- Prefira pedir ao usuário para ativar Configurações -> Geral -> Avançado -> Interface de linha de comando.
- Se você já confirmou a estrutura do arquivo de configuração do app,
~/Library/Application Support/obsidian/obsidian.jsonusa"cli": true. - Reinicie o Obsidian após alterar a configuração da CLI a nível de app.
Fluxo de Leitura
Prefira a CLI oficial para consultas com conhecimento do Obsidian:
cd ~/obsidian
obsidian search query="OpenClaw" format=json
obsidian search:context query="OpenClaw" limit=20 format=json
obsidian read path="Pasta/Nota.md"
obsidian file path="Pasta/Nota.md"
obsidian outline path="Pasta/Nota.md" format=json
obsidian backlinks path="Pasta/Nota.md" format=json
obsidian links path="Pasta/Nota.md"
obsidian properties path="Pasta/Nota.md" format=json
Use leituras diretas do sistema de arquivos quando você já souber o caminho e precisar de bytes exatos:
sed -n '1,220p' "$HOME/obsidian/Pasta/Nota.md"
rg -n "termo" "$HOME/obsidian"
Informe qual fonte você usou quando o frescor ou a escolha do baú forem relevantes.
Fluxo de Escrita
Escolha o caminho de escrita mais restrito:
- Nova nota:
obsidian create path="Pasta/Nota.md" content="...". - Anexar/preceder notas diárias:
obsidian daily:append content="...". - Edições simples de notas: use
apply_patchno arquivo Markdown. - Renomear/mover notas: prefira
obsidian move path="Antiga.md" to="Pasta/Nova.md"para que os links possam ser atualizados. - Abrir a interface após uma escrita: adicione
openapenas quando útil ou solicitado.
Comandos comuns:
cd ~/obsidian
obsidian create path="Notas/Nova.md" content="# Nova\n\nCorpo"
obsidian append path="Notas/Nova.md" content="Mais texto"
obsidian move path="Notas/Nova.md" to="Arquivo/Nova.md"
obsidian daily:path
obsidian daily:read
obsidian daily:append content="- Item de acompanhamento"
Para conteúdo de múltiplas linhas, prefira editar o arquivo .md com apply_patch assim que o caminho for conhecido. Evite citações frágeis em shell para texto longo.
Bases, Canvas, Plugins
Use a descoberta da CLI primeiro:
cd ~/obsidian
obsidian bases
obsidian base:views path="Projetos.base"
obsidian base:query path="Projetos.base" view="Ativo" format=json
obsidian plugins format=json
obsidian plugins:enabled format=json
obsidian commands filter=workspace:
Para arquivos .canvas, .base e .json, leia/edite como dados estruturados quando possível. Mantenha a formatação estável e valide o JSON após edições.
Segurança
- Não reescreva o baú em massa. Use caminhos específicos e revise diferenças.
- Não edite
.obsidian/a menos que o usuário peça ou a tarefa seja explicitamente de configuração/plugins. - Não exclua notas a menos que explicitamente solicitado; prefira a lixeira em vez de exclusão permanente.
- Não crie notas ocultas em pastas com ponto (dot-folder) através do caminho CLI/URI do Obsidian.
- Preserve frontmatter e wikilinks a menos que a tarefa seja refatorá-los.
- Se houver múltiplos baús, não adivinhe; use
obsidian vaultseobsidian.json.