Agent skill · software engineering · hkuds
cli-anything-siyuan
SiYuan (思源笔记) CLI — manage notebooks, documents, blocks, and search your knowledge base from the terminal.
Why this skill is useful
Provides specific commands and workflows for managing SiYuan notebooks and documents that the AI wouldn't reliably generate on its own.
What it needs
Requires python installed locally. About 2k tokens when loaded. Last updated 2026-08-03. 46,739 stars on the source repository.
What this skill does
cli-anything-siyuan CLI harness for 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 Error Handling Connection errors: check that SiYuan is running and the …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills hkuds/skills--165ba7