How long does the integration take?

Change one base URL in an OpenAI-compatible client, or install the Python or TypeScript SDK; the quickstart routes a first request in a few minutes.

Will this lock us into another vendor?

No. The router is Apache-2.0 open source, your provider keys stay yours, and the API is OpenAI-compatible, so leaving is a change of base URL.

What happens when a provider fails?

The router falls back to the next model your policy allows and records the fallback in the trace, so an outage costs a retry, not an incident.

cli-anything-siyuan - Skill

Name: cli-anything-siyuan
Author: hkuds

Imported from hkuds/cli-anything (skills/cli-anything-siyuan/SKILL.md). Install upstream with npx skills add hkuds/cli-anything --skill cli-anything-siyuan. Copyright stays with the author.

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

# 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

Install cli-anything-siyuan and it becomes one more candidate the router can pick - when it fits.

A listing is a routing target with a manifest: what it does, which domains it covers, what it costs and who publishes it. Once installed it sits beside your own models and tools, is scored like any other candidate for each request, and shows up in the trace when it wins. Ratings come from workspaces that installed it, one per account.

{ "ocm": "1", "id": "hkuds-cli-anything-cli-anything-siyuan", "kind": "skill", "name": "cli-anything-siyuan", "description": "SiYuan (思源笔记) CLI — manage notebooks, documents, blocks, and search your knowledge base from the terminal.", "publisher": "hkuds", "version": "1.0.0", "capabilities": { "domains": [ "coding", "data_analysis" ], "tags": [ "skill-md", "skills-sh" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "SiYuan (思源笔记) CLI — manage notebooks, documents, blocks, and search your knowledge base from the terminal." ], "primary": false, "metadata": { "source": { "provider": "skills.sh", "repository": "https://github.com/hkuds/cli-anything", "path": "skills/cli-anything-siyuan/SKILL.md", "ref": "HEAD", "url": "https://github.com/hkuds/cli-anything/blob/HEAD/skills/cli-anything-siyuan/SKILL.md", "key": "hkuds/cli-anything/skills/cli-anything-siyuan/SKILL.md" } }, "instructions": "# cli-anything-siyuan\n\nCLI harness for [SiYuan](https://github.com/siyuan-note/siyuan) (思源笔记),\na local-first knowledge management and note-taking application.\n\nThis CLI connects to a running SiYuan kernel via its HTTP API\n(`http://127.0.0.1:6806`) and provides structured access to notebooks,\ndocuments, blocks, search, and export.\n\n## Prerequisites\n\n- SiYuan must be running (Settings → About shows the API token)\n- Python 3.10+\n- Install: `pip install cli-anything-siyuan` or `pip install -e .` from agent-harness/\n\n## Command Groups\n\n### notebook — Notebook management\n| Subcommand | Description |", "cost": { "context_tokens": 835 } }

cli-anything-siyuan

About

cli-anything-siyuan

Prerequisites

Command Groups

notebook — Notebook management

doc — Document management

block — Block operations

Other commands

Agent Guidance

Examples

Error Handling

Install cli-anything-siyuan and it becomes one more candidate the router can pick - when it fits.

What it costs to adopt - in engineering time.

One base URL

No vendor lock-in

Failover built in

Use it

Manifest

Reviews