cyberneticlibrary

Manage SiYuan note workspace via CLI

siyuan-cliskillsetup L20
frostime/siyuan-cli
What it does

Agent-first CLI for SiYuan Note workspace management and kernel API

Best for

Enabling AI agents to safely read/write SiYuan notes with permission checks and access control

Inputs
  • · CLI subcommands (workspace/doc/api/skill)
  • · SiYuan workspace URL and token
  • · Optional: SQL queries, workspace dir
Outputs
  • · Query results (compact/JSON format)
  • · Document operations (list/create/query)
  • · Workspace status
Requires
  • · SiYuan kernel (local HTTP)
  • · Node.js >=20
Preconditions
  • · SiYuan running locally
  • · Workspace configured with token
Failure modes
  • · Connection refused
  • · Invalid token or SQL syntax
Trust signals
  • · Wraps SiYuan HTTP API safely
  • · Workspace resolution + approval
  • · Built-in docs per subcommand