Transforme uma pasta de notas Markdown (um cofre Obsidian ou um
gbrain export) em um mapa de conhecimento HTML interativo e independente – um gráfico direcionado à força colorido por tema, uma linha do tempo que você pode percorrer para observar o crescimento da base e um painel clique para inspecionar.
Funciona com: Código Claude · OpenAI Codex · Cursor · Gemini CLI · OpenClaw · ou apenas execute o script.
Veja em 5 segundos (sem configuração)
Uma demonstração pré-construída é enviada neste repositório – sem notas para gerar, sem incorporações, sem gbrain, sem Python. Abra o arquivo:
open demo/brain-map.html # macOS
xdg-open demo/brain-map.html # Linux
start demo/brain-map.html # Windows992 notas fictícias sobre três temas (trabalho · estudo · vida). Esfregue a linha do tempo, pressione ▶ Jogue o crescimentoclique em nós, alterne os filtros.
Crie a partir de suas próprias anotações
python3 scripts/build_map.py <notes_dir> out.html --title "My Second Brain"
open out.html = seu cofre de Obsidiana, ou um gbrain export --dir diretório. O mapa mostra Markdown simples: frontmatter YAML (tags, created) + [[wikilinks]].
As dependências são opcionais
| Configurar | Resultado |
|---|---|
| Nada (stdlib somente Python) | Constrói em qualquer lugar; o navegador calcula o layout (Cytoscape cose). |
pip install -r requirements.txt (redex, numpy, scipy) | Layout pré-computado → Mapas de 1.000 nós abrem instantaneamente e parecem mais limpos. |
O construtor detecta automaticamente o networkx e escolhe o melhor caminho. Sem gbrain, sem incorporações, sem necessidade de servidor de qualquer maneira.
- Tema = pasta de nível superior (
Work/,Study/,Life/) → cor do nó e da borda. - Tipo = subpasta / tags → forma do nó (pessoa, reunião, diário, palestra, projeto, link, todo, índice, nota).
- Bordas = resolvido
[[wikilinks]]. Escalas de tamanho de nó com contagem de links; hubs recebem rótulos. - Linha do tempo =
createdcarimbos de data/hora, agrupados por mês, empilhados por tema.
Quanto mais rica for a ligação cruzada (cartões de pessoas, participantes de reuniões, páginas de índice), mais legível será o mapa. Projetado para combinar com a habilidade salvar nota, que escreve exatamente esta forma.
- Esfregar / Jogar a linha do tempo → o gráfico revela as notas até aquele mês; O jogo anima toda a base crescendo desde vazia até hoje.
- Filtro por tema e tipo (contagens ao vivo); procurar destaca partidas.
- Clique um nó → escurecer o resto, iluminar sua vizinhança, abrir um painel de detalhes (resumo, tags, data, notas conectadas).
- Responsivo até um telefone.
Instalar como uma habilidade do agente
Código Claude
git clone https://github.com/vladignatyev/brain-map-skill ~/.claude/skills/brain-mapCódice OpenAI
git clone https://github.com/vladignatyev/brain-map-skill ~/.agents/skills/brain-mapCursor / outros – colar SKILL.md nas instruções do seu agente; é independente.
Gerar novamente o corpus de demonstração
python3 scripts/generate_demo_notes.py /tmp/demo-vault # 992 invented notes
python3 scripts/build_map.py /tmp/demo-vault demo.htmlTodas as pessoas, organizações e eventos de demonstração são fictícios – sem dados reais.
brain-map-skill/
├── SKILL.md # agent skill spec
├── scripts/
│ ├── build_map.py # the builder (Markdown dir → interactive HTML)
│ └── generate_demo_notes.py # writes the fictional demo vault
├── demo/
│ ├── brain-map.html # PREBUILT — open it, zero setup
│ ├── vault/ # 992 source Markdown notes
│ └── preview.png
├── requirements.txt # optional: networkx, numpy, scipy
└── LICENSE
COM
Fonte: theverge

