obsidian-note-reviewer

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:

1. Atualize o binario obsreview com o mesmo instalador do seu sistema (Passo 1).
2. No Claude Code, rode novamente:

/plugin install obsreview@obsidian-note-reviewer

3. 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:

1. Rode:

/plugin marketplace add Donega-Negocios-Digitais/obsidian-note-reviewer

Espere terminar.

2. Depois rode:

/plugin install obsreview@obsidian-note-reviewer

Se o Claude perguntar escopo, selecione:

• Global (Recommended).

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:

1. Claude persiste o plano em /.claude/plans/...;
2. UI abre automaticamente para revisao;
3. Enviar alteracoes devolve feedback para o Claude;
4. Aprovar nota conclui o fluxo (no modo remoto, salva em Meus Documentos).

No fluxo remoto novo, a URL aberta deve conter:

• /hook-review
• sessionId=...
• 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

1. Plugin instalado, mas nada abre:

• reinicie o Claude Code;
• rode obsreview doctor;
• confira se o plano foi salvo em /.claude/plans/....

0. 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.

2. 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.

3. Duvida sobre cache do plugin:

• nao rode bun install dentro de ~/.claude/plugins/cache/...;
• runtime oficial e o binario global obsreview.

4. Login no modo hook:

• remoto pode exigir login;
• local funciona sem login por padrao.

5. 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.

6. 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.