version: "1.0.1" name: siyuan-sisyphus-tag-flashcard description: CLI-only playbook for SiYuan tags and flashcards with siyuan-sisyphus. Use for inline tags, tag discovery and rename, deck discovery, card creation, due/new review, and safe removal.

Manage SiYuan Tags and Flashcards with the CLI

Create tags by writing #tag# into Markdown. Create flashcards with the flashcard action so both riff registration and block metadata remain consistent.

siyuan-sisyphus block append --parent-id '<doc-id>' --data-type 'markdown' --data '#project# #project/phase1#' --json

siyuan-sisyphus tag list --keyword 'project' --json

siyuan-sisyphus tag rename --old-label 'old-tag' --new-label 'new-tag' --json

Flashcard workflow

Create or identify a heading block, discover the target deck, then register the block as a card:

siyuan-sisyphus block append --parent-id '<doc-id>' --data-type 'markdown' --data '## What is spaced repetition?
 
Review just before forgetting.' --json

siyuan-sisyphus flashcard get-decks --json

siyuan-sisyphus flashcard create-card --deck-id '<deck-id>' --block-ids-json '["<heading-block-id>"]' --json

siyuan-sisyphus flashcard list-cards --scope 'deck' --deck-id '<deck-id>' --filter 'due' --json

siyuan-sisyphus flashcard review-card --deck-id '<deck-id>' --card-id '<card-id>' --rating '3' --json

Ratings are 1 through 4, with larger values representing easier recall. Do not imitate flashcard creation with block attributes alone. Before removing a tag or card, show the exact label, deck, and block IDs and obtain approval. Newly written tags and headings may need a short indexing delay before discovery actions show them.