Obsidian pulse

Skill melgarafael/obsidian-master-kit/skills/obsidian-pulse

Esta skill deve ser usada quando o usuario diz "abre meu pulse", "mostra o dashboard", "o que ta acontecendo no vault", "ve os padroes", "sugere o que eu devo fazer agora", ou invoca `/obsidian-master-kit:pulse`. Sobe dashboard FastAPI+HTMX em localhost (default :4711) com insights temporais, sugestoes contextuais via ranking FSRS + bridges + clusters dormentes, deteccao de anomalias (streaks quebrados, keyword emergente, area abandonada), heatmap estilo GitHub, explicabilidade em cada card. 100% local, zero servicos cloud, anti-vigilante (tom sempre aberto, nunca diagnostico).From its SKILL.md

Install

npx -y skills add melgarafael/obsidian-master-kit --skill obsidian-pulse

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

SKILL.md

2.7 KB, as published. Nobody here has run it

obsidian-pulse

"Netflix/YouTube pessoal" rodando 100% local. Worker batch pre-computa insights; dashboard serve em <500ms.

Quando usar

Usuario diz "abre o pulse", "dashboard", "o que ta rolando no vault".
Usuario invoca /obsidian-master-kit:pulse.
Apos scan + organizer: pulse consome suggestions_cache, alerts_cache, clusters, events pra gerar views.

Quando nao usar

Vault sem scan inicial (pulse precisa de notes/events).
Sem deps pulse instaladas: pip install 'obsidian-master-kit[pulse]'.

Fluxo canonico

Passo 1: Detecte o vault

Walk ancestrais procurando .obsidian-master/marker.json. Senao, pede --vault PATH.

Passo 2: Escolha o sub-comando

Intencao do usuario	Sub-comando
"Roda analise e atualiza caches"	`refresh`
"Sobe dashboard localhost"	`serve`
"Tudo junto, em foreground"	`daemon`
"Me da status resumido"	`status`

Passo 3: Invoque o script

python3 ${CLAUDE_PLUGIN_ROOT}/skills/obsidian-pulse/scripts/pulse.py \
  <sub-comando> [--vault PATH] [--port 4711]

Passo 4: Dashboard

http://localhost:4711 (porta configuravel)
Token em .obsidian-master/pulse-token.txt — header X-Pulse-Token
6 tabs: Hoje / Pulso / Grafo / Saude / Descobrir / Insights
Rejeita requests de IPs != 127.0.0.1

Princípios duros (anti-vigilante)

Max 5 insights por dia (LIMIT 5 nas queries).
Max 1 alerta WARN por dia (resto vai pra aba passiva).
Reasoning obrigatorio em cada card — constraint no schema.
Zero LLM no loop — templates deterministicos em pt-br.
Privacy first: sensitive=1 redige titulo em [item em area X].
Pull, nao push: dashboard abre quando Rafael quer; sem notificacao.

CLI: referencia rapida

pulse refresh — roda Stage B (batch analytics: FSRS, anomalies, ranking, cache generation)
pulse serve [--port 4711] — sobe FastAPI+HTMX dashboard
pulse daemon [--port 4711] — refresh + serve em foreground
pulse status — resumo: ultima refresh, contagens, proxima window