cli-anything-siyuan — скилл для Claude Code: что делает и установка
Скилл cli-anything-siyuan подключает агента к SiYuan через CLI: он управляет блокнотами, документами и блоками, ищет по базе и экспортирует документы.
Apache-2.0 255 установок ★ 62 125 обновлён 2026-09-22
npx skills add HKUDS/CLI-Anything --skill cli-anything-siyuan -a claude-codeЧто делает cli-anything-siyuan
Скилл даёт агенту CLI-доступ к запущенному SiYuan через HTTP API. Он умеет создавать, переименовывать, открывать и удалять блокноты и документы, показывать дерево документов, работать с блоками и выполнять полнотекстовый поиск. Есть экспорт документа в Markdown, просмотр тегов, статуса и версии ядра, SQL-запросы и интерактивный REPL.
Для работы нужны запущенный SiYuan, API-токен из Settings → About и Python 3.10+. Сам CLI устанавливается через pip install cli-anything-siyuan или из agent-harness/ командой pip install -e .. Агенту советуют использовать --json, а токен можно хранить в ~/.siyuan-cli.json или передать через SIYUAN_TOKEN.
Без запущенного SiYuan и корректного API-токена CLI не подключится к http://127.0.0.1:6806. Для поиска на уровне базы можно выполнять SQL по таблице blocks, а Markdown разрешено передавать через stdin, чтобы не разбирать экранирование оболочки.
Какие задачи решает
- создать документ в нужном блокноте
- найти блоки по тексту или SQL-запросу
- изменить или удалить блок и документ
- экспортировать документ в Markdown
- проверить подключение и версию ядра SiYuan
Примеры запросов агенту
- Создай документ в блокноте
nb1по пути/projects/newс Markdown из сообщения и верни результат в JSON. - Найди все блоки, где встречается слово «meeting», через SQL и покажи первые результаты.
- Проверь статус подключения к SiYuan, затем экспортируй документ
doc123в Markdown.
Как установить cli-anything-siyuan
1Через Skills CLI (Vercel)
npx skills add HKUDS/CLI-Anything --skill cli-anything-siyuan -a claude-code2Вручную: положить файлы
~/.claude/skills/cli-anything-siyuan/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/cli-anything-siyuan/
1Через Skills CLI (Vercel)
npx skills add HKUDS/CLI-Anything --skill cli-anything-siyuan -a codex2Вручную: положить файлы
.agents/skills/cli-anything-siyuan/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add HKUDS/CLI-Anything --skill cli-anything-siyuan -a cursor2Вручную: положить файлы
.cursor/skills/cli-anything-siyuan/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install HKUDS/CLI-Anything skills/cli-anything-siyuan2Вручную: положить файлы
.github/skills/cli-anything-siyuan/SKILL.md1Через Skills CLI (Vercel)
npx skills add HKUDS/CLI-Anything --skill cli-anything-siyuan -a gemini-cli2Командой платформы
gemini skills install https://github.com/HKUDS/CLI-Anything --path skills/cli-anything-siyuanВручную: положить файлы
.devin/skills/cli-anything-siyuan/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add HKUDS/CLI-Anything --skill cli-anything-siyuan -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о cli-anything-siyuan
Как установить cli-anything-siyuan в Claude Code?
Выполните npx skills add HKUDS/CLI-Anything --skill cli-anything-siyuan -a claude-code, затем проверьте файл ~/.claude/skills/cli-anything-siyuan/SKILL.md.
Что делает cli-anything-siyuan?
Скилл позволяет агенту управлять блокнотами, документами и блоками SiYuan из терминала, искать по содержимому, выполнять SQL и экспортировать документы в Markdown.
Что нужно для работы cli-anything-siyuan?
Нужны запущенный SiYuan, API-токен из Settings → About и Python 3.10+. При ошибке авторизации проверьте токен в ~/.siyuan-cli.json или переменную SIYUAN_TOKEN.
Исходный текст
SKILL.md · Apache-2.0
---
name: "cli-anything-siyuan"
description: SiYuan (思源笔记) CLI — manage notebooks, documents, blocks, and search your knowledge base from the terminal.
---
# cli-anything-siyuan
CLI harness for [SiYuan](https://github.com/siyuan-note/siyuan) (思源笔记),
a local-first knowledge management and note-taking application.
This CLI connects to a running SiYuan kernel via its HTTP API
(`http://127.0.0.1:6806`) and provides structured access to notebooks,
documents, blocks, search, and export.
## Prerequisites
- SiYuan must be running (Settings → About shows the API token)
- Python 3.10+
- Install: `pip install cli-anything-siyuan` or `pip install -e .` from agent-harness/
## Command Groups
### notebook — Notebook management
| Subcommand | Description |
|------------|-------------|
| `list` | List all notebooks |
| `create <name>` | Create a new notebook |
| `rename <id> <name>` | Rename a notebook |
| `remove <id>` | Delete a notebook |
| `open <id>` | Open a notebook |
### doc — Document management
| Subcommand | Description |
|------------|-------------|
| `create <notebook> <path> [--md "content"]` | Create a document |
| `list <notebook> [path]` | List documents |
| `tree <notebook> [--path / --depth]` | Show doc tree |
| `get <id>` | Get document path by ID |
| `rename <id> <title>` | Rename a document |
| `remove <id>` | Delete a document |
### block — Block operations
| Subcommand | Description |
|------------|-------------|
| `insert <data> [--previous / --parent]` | Insert a block |
| `update <id> <data>` | Update a block |
| `delete <id>` | Delete a block |
| `get <id>` | Get block kramdown source |
| `children <id>` | Get child blocks |
### Other commands
| Command | Description |
|---------|-------------|
| `sql <stmt>` | Execute SQL on the block database |
| `search <query>` | Full-text search across blocks |
| `export md <doc-id>` | Export document as Markdown |
| `tag list` | List all tags |
| `version` | Show SiYuan kernel version |
| `status` | Show connection and session status |
| `repl` | Start interactive REPL |
## Agent Guidance
- Always use `--json` for machine-readable output
- Power search: use `sql "SELECT * FROM blocks WHERE content LIKE '%keyword%'"` for SQL-level access
- Document IDs look like `20210817205410-2kvfpfn` (timestamp-based)
- API token can be found in SiYuan Settings → About
- Connection defaults: `http://127.0.0.1:6806`
## Examples
```bash
# List notebooks (JSON)
cli-anything-siyuan --json notebook list
# Create a document with Markdown (--md flag, watch shell escaping)
cli-anything-siyuan doc create nb1 /projects/new --md "## Title\n\nContent"
# Create a document — pipe Markdown via stdin (avoids shell escaping)
# PowerShell here-string (literal, no escaping needed):
@'
## Title
Content with `backticks` and (parentheses) and "quotes"
'@ | cli-anything-siyuan doc create nb1 /projects/new --md -
# Bash heredoc:
# cat <<'EOF' | cli-anything-siyuan doc create nb1 /projects/new --md -
# ## Title
# Content with `backticks` and (parentheses)
# EOF
# SQL search
cli-anything-siyuan sql "SELECT id, content FROM blocks WHERE content LIKE '%meeting%' LIMIT 5"
# Export
cli-anything-siyuan export md doc123
# Enter REPL
cli-anything-siyuan
```
## Error Handling
- Connection errors: check that SiYuan is running and the API token is correct
- API errors: returned as `{"code": N, "msg": "..."}` — check the message field
- Auth errors: verify the token in `~/.siyuan-cli.json` or `SIYUAN_TOKEN` env var
© HKUDS · Apache-2.0 · HKUDS/CLI-Anything