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

wiki-cli — скилл для Claude Code: что делает и как установить

Скилл wiki-cli проверяет, можно ли читать хранилище Obsidian через официальный CLI, и ищет по заметкам. Если CLI не готов, читает файлы напрямую.

MIT 341 установок ★ 16 676 обновлён 2026-10-22

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add AgriciDaniel/claude-obsidian --skill wiki-cli -a claude-code
Открыть на GitHub

Что делает wiki-cli

Скилл решает одну задачу: понять, чем читать хранилище Obsidian, и прочитать или найти нужную заметку. Он запускает scripts/detect-transport.sh с флагом --peek и смотрит на available.cli.usable. Одного бинарника obsidian мало: CLI не отвечает, если приложение закрыто или доступ из командной строки выключен.

Когда CLI готов, команды идут изнутри папки хранилища: obsidian read path=... и obsidian search query=.... Для бэклинков, тегов и результатов Bases есть отдельные команды только для чтения. Когда CLI не готов, агент читает файлы и ищет через rg. Абсолютные пути, обход через .. и симлинки за пределы хранилища отклоняются.

Записывать скилл не умеет. Создание, правка, перенос и удаление заметок через CLI запрещены, прямая запись в файлы тоже. Любое изменение идёт одной проверяемой транзакцией через ядро claude-obsidian, а скрипт детекта скилл ищет в каталоге установленного claude-obsidian, поэтому без него проверка не стартует. Файл .vault-meta/transport.json обновляется с --force только по просьбе.

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

  • проверить, отвечает ли Obsidian CLI, до первой команды
  • прочитать заметку по пути внутри хранилища
  • найти заметки по запросу через obsidian search
  • получить бэклинки и теги, когда CLI готов
  • искать по хранилищу через rg, если CLI недоступен

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

  • Проверь через wiki-cli, работает ли Obsidian CLI для моего хранилища
  • Найди в хранилище Obsidian заметки про OAuth через wiki-cli
  • Прочитай заметку и покажи её бэклинки через Obsidian CLI

Как установить wiki-cli

1Через Skills CLI (Vercel)

npx skills add AgriciDaniel/claude-obsidian --skill wiki-cli -a claude-code

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

~/.claude/skills/wiki-cli/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/wiki-cli/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о wiki-cli

Как установить wiki-cli в Claude Code?

Выполните npx skills add AgriciDaniel/claude-obsidian --skill wiki-cli -a claude-code. Файл скилла — ~/.claude/skills/wiki-cli/SKILL.md.

Что делает wiki-cli?

Определяет, доступен ли Obsidian CLI, и читает или ищет по выбранному хранилищу только на чтение. Если CLI не готов, скилл читает файлы напрямую.

Работает ли wiki-cli без запущенного Obsidian?

CLI требует запущенное приложение и включённый доступ из командной строки. Без этого скилл переходит на чтение файлов и поиск через rg.

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

SKILL.md · MIT
---
name: wiki-cli
description: "Detect and use the official Obsidian command-line interface for read-only vault access; use for wiki-cli, Obsidian CLI, Obsidian read, Obsidian search, vault transport, which transport, transport detection, backlinks, tags, or Obsidian command line. Mutations always go through the claude-obsidian transaction core."
---

# Obsidian CLI read transport

Use this skill only to detect transport and read or search a selected vault.
The official executable is `obsidian`; binary presence alone does not prove it
is usable.

Resolve the installed product root from this skill's own location, not from the
vault or current working directory:

```bash
PRODUCT_ROOT=/absolute/path/to/installed/claude-obsidian
DETECT_TRANSPORT="$PRODUCT_ROOT/scripts/detect-transport.sh"
test -f "$DETECT_TRANSPORT"
```

Every `../wiki/references/` link in this file resolves the same way, relative
to this skill's own directory under `$PRODUCT_ROOT`, never relative to the
selected vault's `wiki/` directory.

## Detect safely

Probe without persisting host state:

```bash
bash "$DETECT_TRANSPORT" --peek --vault "$VAULT"
```

Trust `available.cli.usable`, not merely `present` or exit status. A supported
CLI can still be unavailable because the Obsidian app is not running, command
line access is disabled, or its response is an error. Use filesystem reads as
the portable fallback.

Persist a refreshed `.vault-meta/transport.json` only when the user or setup
workflow asks for a transport snapshot:

```bash
bash "$DETECT_TRANSPORT" --force --vault "$VAULT"
```

That file is derived runtime configuration, not knowledge content. Preserve a
valid `manual_override` recorded by the detector.

## Read and search

Run official CLI commands from the selected vault so Obsidian resolves the
correct workspace. Confirm supported syntax with the installed CLI before
relying on optional commands. Typical read-only forms are:

```bash
(cd "$VAULT" && obsidian read path="$NOTE")
(cd "$VAULT" && obsidian search query="$QUERY")
```

Use read-only commands for backlinks, tags, or Bases results only when the
detector reports the CLI ready. Otherwise read files under `$VAULT` directly
and use `rg` for search. Reject absolute note arguments, traversal, symlinks, or
resolved paths outside the selected vault.

## Mutation boundary

Do not use CLI create, write, append, property-set, daily-append, move, rename,
or delete commands. Do not replace those commands with direct filesystem
writes. Any knowledge or configuration change must be expressed as one
reviewed transaction through the portable core; see
[operation transactions](../wiki/references/operation-transactions.md).

Transport choice never changes mutation semantics. The CLI is an optional read
surface, not a lock manager, transaction engine, or Git checkpoint mechanism.

## Checkpoint

Observe actual capability, think about the least complex read transport, verify
that every resolved path stays in the vault, and accept filesystem fallback
when the CLI is not ready.

© AgriciDaniel · MIT · AgriciDaniel/claude-obsidian

Похожие скиллы

Все скиллы по теме «Заметки, задачи и проекты» →
wiki-context-pack Ar9av Скилл wiki-context-pack для Claude Code, Codex, Cursor, GitHub Copilot и Gemini CLI вырезает из хранилища Obsidian ограниченный по токенам срез с готовыми цитатами для агента. CX Codex +1 1 700установок obsidian-find Eugeniu Ghelbur Команда obsidian-find ищет записи в хранилище Obsidian с выдержками, типами заметок и контекстом вместо простого списка имён файлов. CX Codex +1 ★ 5 412звёзд репо codex-obsidian Greg Asher Плагин codex-obsidian связывает агента с локальным хранилищем Obsidian через официальный десктопный CLI. Помогает искать заметки, сводить задачи и управлять вкладками. CX Codex ★ 1 596звёзд репо obsidian openclaw Подключает официальный obsidian CLI для чтения, поиска, создания и редактирования заметок в хранилище Obsidian. CX Codex +1 6 400установок llm-wiki Ar9av Скилл llm-wiki для Claude Code задаёт устройство личной вики в Obsidian: слои источников, категории, проекты и шаблон страницы. Определяет структуру хранения знаний, а не загрузку файлов. CX Codex +1 4 200установок pp-obsidian LARGE FORMAT Скилл pp-obsidian для Claude Code читает статистику и метаданные хранилища Obsidian: сломанные ссылки, потерянные заметки, тэги и задачи. Анализирует локальное зеркало SQLite без живого подключения. CX Codex +1 136установок

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

Весь набор →
wiki-query Скилл wiki-query отвечает на вопрос по выбранному хранилищу Obsidian и не меняет в нём ни одного файла. Полезен, когда источником доказательств назначена сама вики. CX Codex +1 512установок wiki-lint Скилл wiki-lint прогоняет детерминированную проверку Obsidian-вики: битые ссылки, страницы-сироты, пробелы во frontmatter. Ничего не правит — только показывает. CX Codex +1 508установок canvas Создаёт и правит доски Obsidian в формате JSON Canvas: текстовые блоки, файлы, ссылки, группы и связи между узлами. Собирает визуальную карту хранилища. CX Codex +1 500установок defuddle Планирует извлечение через Defuddle и сохраняет уже готовые локальные файлы в хранилище. Сетевой очистки внутри нет — только план и захват. CX Codex +1 478установок wiki-fold Скилл wiki-fold для Claude Code собирает сводку из записей wiki/log.md в хранилище Obsidian. По запросу на свёртку он сначала показывает черновик и не меняет дочерние страницы. CX Codex +1 445установок wiki-retrieve Скилл wiki-retrieve для Claude Code строит локальный BM25-индекс заметок из wiki/ и ищет в нём фрагменты. Находит связанные страницы для передачи агенту на разбор. CX Codex +1 348установок wiki-mode Скилл wiki-mode определяет методологию хранилища Obsidian (PARA, LYT, Zettelkasten или Generic) и предлагает папки для новых заметок без перезаписи существующих файлов. CX Codex +1 344установок think Скилл применяет десятиэтапный цикл OBSERVE–LISTEN–THINK–CONNECT–FEEL–ACCEPT–CREATE–GROW к сложным решениям, архитектурным выборам и разборам. Помогает отделить факты от предположений и выявить скрытые риски. CX Codex +1 337установок

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

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