obsidian-note-reviewer
Revisao interativa de planos e notas com UI visual, integrada ao Claude Code.
Instalacao oficial
Guia para usuario final instalar e usar.
Passo 0 - Se voce ja instalou antes, atualize tudo primeiro
Se ja tinha versao antiga instalada, rode novamente:
- Atualize o binario
obsreview com o mesmo instalador do seu sistema (Passo 1).
- No Claude Code, rode novamente:
/plugin install obsreview@obsidian-note-reviewer
- Reinicie o Claude Code.
Objetivo: evitar cache antigo de plugin/hook.
Passo 1 - Instalar o binario obsreview (terminal do sistema)
Rode apenas um comando, de acordo com seu sistema:
Windows (PowerShell)
irm https://raw.githubusercontent.com/Donega-Negocios-Digitais/obsidian-note-reviewer/main/scripts/install.ps1 | iex
Windows (CMD)
curl -fsSL https://raw.githubusercontent.com/Donega-Negocios-Digitais/obsidian-note-reviewer/main/scripts/install.cmd -o install.cmd && install.cmd && del install.cmd
macOS / Linux / WSL
curl -fsSL https://raw.githubusercontent.com/Donega-Negocios-Digitais/obsidian-note-reviewer/main/scripts/install.sh | bash
Passo 2 - Validar que o binario instalou
No terminal:
obsreview --version
obsreview --help
obsreview doctor
Sinal de sucesso:
--version mostra um numero de versao;--help mostra lista de comandos;doctor mostra checks locais.
Se obsreview --version nao mostrar nada:
- o binario instalado esta invalido/desatualizado;
- rode o instalador novamente para baixar a release mais nova;
- feche e abra o terminal;
- teste de novo
obsreview --version antes de seguir.
Passo 3 - Abrir Claude Code na pasta certa
Abra o Claude Code em uma pasta de projeto com escrita.
Nao use pasta de sistema (exemplo: System32).
Passo 4 - Instalar plugin no Claude Code (um comando por vez)
No chat do Claude Code:
- Rode:
/plugin marketplace add Donega-Negocios-Digitais/obsidian-note-reviewer
Espere terminar.
- Depois rode:
/plugin install obsreview@obsidian-note-reviewer
Se o Claude perguntar escopo, selecione:
Passo 5 - Reiniciar Claude Code
Feche e abra o Claude Code novamente para carregar hooks e slash commands.
Passo 6 - Teste real do fluxo
No chat do Claude Code:
Crie um plano de 2 passos para criar uma mini apresentacao, sem implementar.
Resultado esperado:
- Claude persiste o plano em
/.claude/plans/...;
- UI abre automaticamente para revisao;
Enviar alteracoes devolve feedback para o Claude;Aprovar nota conclui o fluxo (no modo remoto, salva em Meus Documentos).
No fluxo remoto novo, a URL aberta deve conter:
/hook-reviewsessionId=...reviewKey=...revisionId=...mode=plan-live-review
Se abrir a app sem esses parametros, voce ainda esta em versao antiga/cache antigo.
Mensagens esperadas (guia rapido)
| Comando | Sinal de sucesso | Proximo passo |
|---|
obsreview --version | Mostra numero de versao | Rodar obsreview --help |
/plugin marketplace add ... | Marketplace adicionado | Rodar /plugin install ... |
/plugin install ... | Plugin instalado | Reiniciar Claude Code |
| Prompt de teste | UI abriu para revisar plano | Testar Enviar alteracoes e Aprovar nota |
Verificacao opcional (usuario)
Se quiser confirmar rapidamente que esta tudo certo no seu computador:
obsreview --version
obsreview --help
obsreview doctor
Problemas comuns
- Plugin instalado, mas nada abre:
- reinicie o Claude Code;
- rode
obsreview doctor;
- confira se o plano foi salvo em
/.claude/plans/....
obsreview --version sem saida:
- reinstale o binario com o instalador oficial do seu sistema;
- reabra o terminal;
- valide
obsreview --version e obsreview --help antes de instalar/reinstalar plugin.
- Abre a app, mas sem o documento de revisao:
- atualize binario + plugin (Passo 0);
- reinicie o Claude Code;
- rode o prompt de teste novamente;
- confirme se a URL aberta tem
reviewKey e revisionId.
- Duvida sobre cache do plugin:
- nao rode
bun install dentro de ~/.claude/plugins/cache/...;
- runtime oficial e o binario global
obsreview.
- Login no modo hook:
- remoto pode exigir login;
- local funciona sem login por padrao.
- Fechei a aba de revisao e nao abriu de novo:
- o hook evita duplicar abas em revisoes rapidas da mesma sessao;
- durante a mesma sessao de review remota, ele nao abre nova aba automaticamente;
- abra manualmente a aba da sessao se voce a fechou.
- Navegador:
- por padrao, o
obsreview abre no navegador padrao do sistema;
- isso significa: abre no navegador que a pessoa usa normalmente (e ja esta logada).
- nao precisa rodar comando para isso.
