siyuan-sisyphus

Translates Model Context Protocol (MCP) tool definitions into executable CLI subcommands that directly invoke SiYuan's HTTP API endpoints. The artifact wraps SiYuan's native MCP tools (block operations, document management, etc.) as shell-callable commands, parsing arguments into JSON payloads and routing them to the SiYuan kernel via HTTP requests. This enables programmatic note manipulation without GUI interaction.

Provides granular control over SiYuan's block-based document structure through CLI commands (block append, insert, update, delete). Each command maps to SiYuan's block API endpoints, accepting parent block IDs and content payloads, then executing atomic operations on the note tree. Supports hierarchical block operations (nested lists, outlines) and preserves SiYuan's internal block metadata and relationships.

Provides commands to create, list, query, and manage SiYuan documents and notebooks from the command line. Maps to SiYuan's document API endpoints, allowing users to create new documents, organize them into notebooks, and retrieve document metadata and structure without GUI interaction. Supports querying document hierarchies and retrieving document IDs for downstream block operations.

Provides CLI commands to query and retrieve block and document attributes, including custom attributes, tags, and metadata stored in SiYuan's attribute system. Maps to SiYuan's attribute API endpoints, allowing users to search for blocks by attribute values, retrieve attribute definitions, and filter results based on metadata without loading the GUI. Supports both system attributes (creation date, block type) and user-defined attributes.

Provides a CLI interface to SiYuan's SQL query API, allowing users to execute SQL queries against SiYuan's internal database to retrieve blocks, documents, and relationships. Maps to SiYuan's SQL endpoint, accepting arbitrary SQL statements and returning structured results. Enables complex queries combining multiple tables (blocks, documents, attributes) without requiring multiple CLI invocations or shell-based post-processing.

Provides CLI commands to create new notes from templates, with variable substitution and dynamic content generation. Maps to SiYuan's template API endpoints, allowing users to specify a template document and provide variable values that are substituted into the template before creating the new note. Supports nested templates and conditional blocks based on variable values.

Provides CLI commands to execute multiple block operations (create, update, delete) as a logical unit, with error handling and optional rollback on failure. Implements a transaction-like pattern where operations are queued, validated, and executed together, with the ability to roll back all changes if any operation fails. Supports dry-run mode to preview changes before committing.

Provides CLI commands to register webhooks and event listeners that trigger SiYuan operations in response to external events (file changes, API calls, scheduled tasks). Maps to SiYuan's webhook API, allowing users to define event handlers that execute block operations, document creation, or other SiYuan actions when events occur. Supports filtering events by type, source, and payload criteria.