How do I install the Obsidian Pulse skill?

Run npx skillmds@latest add melgarafael/obsidian-pulse in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Obsidian Pulse safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Obsidian Pulse?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Obsidian Pulse free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Obsidian Pulse?

melgarafael (@melgarafael) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Obsidian Pulse by melgarafael — Agent Skill

Name: Obsidian Pulse
Author: melgarafael

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

melgarafael 6a57e03 9 files · 62.6 KB Updated Sep 17, 2026

File contents

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

---name: obsidian-pulsedescription: 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).---# obsidian-pulse"Netflix/YouTube pessoal" rodando 100% local. Worker batch pre-computainsights; 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 vaultWalk 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```bashpython3 ${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)1. **Max 5 insights por dia** (`LIMIT 5` nas queries).2. **Max 1 alerta WARN por dia** (resto vai pra aba passiva).3. **Reasoning obrigatorio** em cada card — constraint no schema.4. **Zero LLM no loop** — templates deterministicos em pt-br.5. **Privacy first**: `sensitive=1` redige titulo em `[item em area X]`.6. **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

Frequently asked questions