К основному содержанию
команда CX Codex

obsidian-visualize — команда Claude Code: граф знаний в Canvas

Команда obsidian-visualize строит интерактивную карту вашего хранилища Obsidian: показывает, как связаны заметки, находит центральные узлы и выявляет изолированные записи. Полезна, чтобы увидеть структуру своей второй мозг целиком.

MIT ★ 5 412 обновлён 2026-10-24

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add eugeniughelbur/obsidian-second-brain
/plugin install obsidian-second-brain@obsidian-second-brain
Открыть на GitHub

Что делает obsidian-visualize

Команда читает хранилище и генерирует визуальный граф в формате Obsidian Canvas. Вместо того чтобы загружать все заметки в контекст, она использует сканер — это экономит бюджет токенов на больших вилтах. Граф отображает узлы (заметки) и рёбра (связи между ними), цветит их по типам: сущности синим, проекты зелёным, концепции фиолетовым, ежедневники серым, источники оранжевым.

Команда поддерживает область видимости: можно визуализировать весь вилт или сфокусироваться на конкретной заметке и её двухшаговом окружении. Результат включает текстовый отчёт: топ-узлы по центральности, мосты между кластерами, орфанные заметки (без связей), семантические типы связей (если во фронтматтере relations:). Граф сохраняется как atlas.canvas в корне вилта и открывается прямо в Obsidian.

Команда требует, чтобы в вилте был установлен скилл obsidian-second-brain. Фронтматтер всех создаваемых или обновляемых заметок должен следовать правилам из references/ai-first-rules.md.

Какие задачи решает

  • увидеть топологию вилта без ручного рисования
  • найти самые связанные заметки (хабы, через которые «всё течёт»)
  • обнаружить изолированные записи, которые никак не связаны
  • выделить цепочки причинно-следственных связей через типы отношений
  • определить мосты между кластерами знаний

Примеры запросов агенту

  • Визуализируй весь мой вилт — покажи граф всех заметок
  • Построй Canvas для проекта «Tide Gateway» со всеми связанными идеями
  • Сверни граф только на сущности и их связи, исключи ежедневники

Как установить obsidian-visualize

1Через маркетплейс плагинов

/plugin marketplace add eugeniughelbur/obsidian-second-brain
/plugin install obsidian-second-brain@obsidian-second-brain

2Вручную: положить файлы

.claude/commands/obsidian-visualize.md

Вызов — /obsidian-visualize. Для всех проектов — ~/.claude/commands/

Вопросы об obsidian-visualize

Как установить obsidian-visualize в Claude Code?

Выполни по порядку: /plugin marketplace add eugeniughelbur/obsidian-second-brain, затем /plugin install obsidian-second-brain@obsidian-second-brain, затем добавь файл .claude/commands/obsidian-visualize.md в проект.

Что делает obsidian-visualize?

Команда сканирует твоё хранилище Obsidian, строит граф связей между заметками и экспортирует его в интерактивный Canvas. Ты видишь структуру вилта: где находятся узлы-хабы, какие заметки изолированы, как кластеры друг с другом связаны.

Можно ли визуализировать только часть вилта?

Да, передай точное имя заметки или её алиас как аргумент команды — граф будет включать эту заметку и её двухшаговое окружение. По умолчанию визуализируется весь вилт.

Исходный текст

obsidian-visualize.md · MIT
---
description: Generate a visual canvas map of your vault - see the shape of your second brain and how knowledge connects
category: meta
triggers_en: ["visualize vault", "vault map", "canvas of vault", "show me the vault shape"]
triggers_de: ["Vault visualisieren", "Vault-Karte", "Vault als Canvas", "zeige mir die Struktur meines Vaults"]
triggers_es: ["visualiza el vault", "mapa del vault", "canvas del vault", "muéstrame la forma de mi vault"]
triggers_pt: ["visualize o vault", "mapa do vault", "canvas do vault", "mostre a forma do vault"]
triggers_zh: ["把知识库可视化", "生成知识图谱画布", "画出我的笔记关系", "看看知识库的整体结构"]
---

Use the obsidian-second-brain skill. Execute `/obsidian-visualize $ARGUMENTS`:

The optional argument is a scope: an EXACT note title or alias (a project, an entity), or "full" for the entire vault. Default: full vault. A free-form topic phrase will not match - resolve it to a real note title first (e.g. via /obsidian-find).

1. Read `_CLAUDE.md` first if it exists in the vault root

2. Build the graph deterministically with the scanner instead of reading every note into context (a full-vault read is O(read-everything) and burns the budget). Run from the skill root (its absolute path was given at session start as **Skill root**; substitute it for `SKILL_ROOT`):
   ```bash
   uv run --directory "SKILL_ROOT" scripts/link_graph.py --path "<vault>" [--scope "<topic/project/entity>"]
   ```
   It returns JSON with `nodes` (path, title, `type`, folder, in/out/`degree`), `edges` (resolved `[[wikilink]]` pairs, each `{from, to, type: "link"}`), `typed_edges` (the semantic overlay from `relations:` frontmatter - `{from, to, type}` where type is `supersedes`, `depends_on`, `caused`, etc. per `references/ai-first-rules.md` Rule 6), `typed_edge_problems` (unhonored typed edges), and `stats` (`node_count`, `edge_count`, `typed_edge_count`, `orphan_count`, `dangling_link_count`, `top_hubs`, `orphans`). Pass `--scope` with an exact note title/alias (the script keeps that note plus its 2-hop neighborhood); omit it for the full vault. If the result has `node_count: 0`, the scope did not resolve to a note - find the real title and rerun. Use this JSON as the graph - only open individual notes if you need a label the scan did not provide.

3. Generate a JSON Canvas file (`.canvas`) compatible with Obsidian's native canvas viewer:

   Structure:
   ```json
   {
     "nodes": [
       {"id": "1", "type": "file", "file": "wiki/entities/Ada Lovelace.md", "x": 0, "y": 0, "width": 250, "height": 60},
       {"id": "2", "type": "file", "file": "wiki/projects/Tide Gateway.md", "x": 300, "y": 0, "width": 250, "height": 60}
     ],
     "edges": [
       {"id": "e1", "fromNode": "1", "toNode": "2"}
     ]
   }
   ```

   Layout rules:
   - **Hub nodes** (most links) go in the center, larger
   - **Cluster by type**: entities on the left, projects top-right, concepts bottom-right, daily notes bottom
   - **Color by type**: entities = blue, projects = green, concepts = purple, daily = gray, sources = orange
   - **Edge labels** = when two nodes connect through multiple links, record the count in the edge `label` (JSON Canvas edges have no thickness property). When a `typed_edges` entry connects the same pair, label the edge with the relation type instead (e.g. `supersedes`, `depends_on`) - a typed edge is more informative than a count
   - **Orphan nodes** placed at the edges with a red border (easy to spot)

4. Save to vault root as `atlas.canvas` (or `atlas-{topic}.canvas` if scoped)

5. Also generate a text summary with centrality ranking (use the scanner's `stats` and per-node `degree`/`in`/`out` directly - do not recompute by hand):
   - Total nodes and edges (`stats.node_count`, `stats.edge_count`), plus the `dangling_link_count` (wanted notes - links to unwritten notes).
   - **Typed edges** - if `stats.typed_edge_count` > 0, summarize the semantic overlay: count by relation type (from `typed_edges`), name the longest `supersedes`/`depends_on`/`caused` chains (these are the reasoning paths flat links can't express), and flag any `typed_edge_problems` as a nudge to run `/obsidian-health` for the full lint. If it's 0, note that the vault has no typed edges yet and point to `references/ai-first-rules.md` Rule 6 as the way to add them.
   - **Hub nodes (centrality)** - top 5 from `stats.top_hubs` (already ranked by degree), each with its link count and a one-line "everything flows through this because..." note. A hub qualifies if its degree is at least 3x the median, or it sits in the top 1% of the vault - whichever surfaces fewer.
   - **Bridge nodes** - nodes that, if removed, would split a cluster. Rank by betweenness (approximate: count the shortest paths each node sits on between the top-10 hubs). These are the load-bearing connectors; surface the top 3 with the two clusters each one joins.
   - **Orphan nodes** - no connections, listed by type. Flag any that are >30 days old (stale orphans are higher-priority cleanup targets than fresh ones).
   - **Clusters** - groups of tightly connected notes, named by their hub. Note any cluster with <3 cross-cluster edges (those are silos).
   - **Centrality skew** - if one node holds >25% of total edges, call it out as a single point of failure for navigation.

6. Append to the operation log: if `Logs/` exists write `**HH:MM** - visualize | Canvas generated - X nodes, Y edges, Z orphans` to `Logs/YYYY-MM-DD.md`; otherwise append `## [YYYY-MM-DD] visualize | Canvas generated - X nodes, Y edges, Z orphans` to `log.md`

The user can open the `.canvas` file in Obsidian to visually explore their vault's knowledge graph.

---

**AI-first rule:** Every note created or updated by this command MUST follow `references/ai-first-rules.md` - `## For future agent` preamble, rich frontmatter (`type`, `date`, `tags`, `ai-first: true`, plus type-specific fields), recency markers per external claim, mandatory `[[wikilinks]]` for every person/project/concept referenced, sources preserved verbatim with URLs inline, and confidence levels where applicable. If that path does not resolve from your working directory, search upward for it; if you still cannot read it, say so before writing rather than producing a note that silently skips the rule. The vault is for future agent retrieval - not human reading.

**Anti-fabrication:** Search exhaustively before claiming any note, person, or file is absent - false absence is the most common failure mode - and never invent facts, entities, or dates (mark unknowns as `TBD`). See the anti-fabrication and search-completeness hard rules in `references/ai-first-rules.md`.

© Eugeniu Ghelbur · MIT · eugeniughelbur/obsidian-second-brain

Похожие слэш-команды

Все слэш-команды по теме «Заметки, задачи и проекты» →
obsidian-canvas-creator axtonliu Скилл obsidian-canvas-creator для Claude Code, Cursor, Codex и других агентов: превращает текст в файл Obsidian Canvas с раскладкой MindMap или произвольной сеткой. Агент строит JSON-граф прямо в чате — готовый к импорту в Obsidian. CX Codex +1 2 000установок obsidian-kb-artifacts Galaxy-Dawn Скилл obsidian-kb-artifacts для Claude Code и Codex работает с форматированием Obsidian и производными артефактами: вики-ссылками, таблицами реестра, canvas-файлами, базами и восстановлением связей. CX Codex +1 328установок Obsidian Brain sweir1 Локальный MCP-сервер Obsidian Brain, который даёт агенту семантический поиск, граф связей и запись в хранилище Obsidian. Работает с обычными .md-файлами на диске. CX Codex +1 ★ 14звёзд репо temple-generator glebis Скилл temple-generator превращает базу заметок Obsidian в трёхмерную интерактивную карту Three.js с кольцами сущностей, семантическим зумом и звуком. CX Codex +1 199установок visualize scaccogatto Скилл visualize для Claude Code строит интерактивный HTML-граф OKF-бандла: концепты — узлы, ссылки — рёбра, панель показывает отрендеренный Markdown. CX Codex +1 946установок obsidian-headless obsidianmd Скилл obsidian-headless для Claude Code запускает синхронизацию и публикацию хранилищ Obsidian через терминал без графического приложения. Он выполняется на сервере, в CI и в песочнице. CX Codex +1 1 200установок

Из того же набора51

Весь набор →
podcast Команда podcast извлекает метаданные, расшифровку и саммари эпизода подкаста, сохраняя готовую заметку в хранилище Obsidian. CX Codex +1 ★ 5 412звёзд репо youtube Извлекает расшифровку, метаданные и популярные комментарии YouTube, затем сохраняет сводку в Obsidian. Флаг --visual добавляет анализ кадров. CX Codex +1 ★ 5 412звёзд репо obsidian-architect Команда obsidian-architect сканирует проект и генерирует набор архитектурных заметок в хранилище: обзор, заметки по модулям, ключевые решения. Переустановка обновит документацию без потери ваших правок. CX Codex +1 ★ 5 412звёзд репо obsidian-reconcile Команда obsidian-reconcile для Claude Code выявляет противоречия в Obsidian-vault и разрешает их автоматически или выносит на решение. Сканирует всё хранилище или отдельную тему, сверяя утверждения и свежесть источников. CX Codex +1 ★ 5 412звёзд репо obsidian-distill Команда obsidian-distill сжимает длинную заметку или статью до списка тезисов, каждый с отметкой, откуда он взят — параграф, секция или timestamp. CX Codex +1 ★ 5 412звёзд репо obsidian-merge Команда obsidian-merge объединяет дублирующиеся заметки в Obsidian без удаления файлов. Сохраняет канонический текст, переносит связи и превращает старую заметку в ссылку-перенаправление. CX Codex +1 ★ 5 412звёзд репо obsidian-checkin Команда obsidian-checkin сверяет старые заметки с ответами владельца хранилища и сохраняет обновления. Она пригодится, когда сведения о людях или проектах могли измениться. CX Codex +1 ★ 5 412звёзд репо research-deep Команда research-deep сканирует ваше хранилище Obsidian, выявляет пробелы в информации и заполняет их через Perplexity или Grok, потом синтезирует результат и автоматически обновляет заметки о людях, проектах и идеях. CX Codex +1 ★ 5 412звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой