Craft

Read/search Craft; prefer semicolon batches when inputs/IDs are known; split calls for result dependencies. Keywords: find/open/read/search docs/pages/cards/blocks, daily notes, tasks/inbox/logbook, folders/spaces, collections/tables/schema/items/fields/relations, links/URLs/richUrl, images/files/videos, themes/washi. Cmds: folders list [--filter <regex>] folders explore-icons <term> documents list [--location unsorted|trash|templates|daily_notes | --folder <folderId>] documents resolve-link <url> -> rootBlockId for block commands tasks list [--scope active|upcoming|inbox|logbook|document|all] # all = every task block in full-space, not a union of other scopes blocks get <rootBlockId> [--depth <depth>] [--format json|markdown] blocks get --date today blocks explore-themes --type page|fonts|code blocks explore-washi blocks search-unsplash <query> collections list [--document <rootBlockId>] collections schema --collection <collectionId> collections items-get --collection <collectionId> collections views-list --collection <collectionId> internal-links get [--from-document id] [--to-document id] # outgoing links / backlinks; titles + counts connection info whiteboards elements get --whiteboard <whiteboardId> images view --url <image-url> search <query> [--location unsorted|trash|templates|daily_notes] [--limit N] # save tokens: 5, then next 10/20 via cursor Common flags: --offset, --cursor, --filter <regex>, --format json|markdown. Help: "<entity> <action> --help". Find named docs with search; follow links for missing context. Batch: blocks get A; internal-links get --from-document A. Craft editor/app links: 'documents resolve-link <url>' -> rootBlockId. Published share URLs are web pages: use web tools, not resolve-link/internal-links; never infer IDs from share tokens. Block reminders: reminders list [--status incomplete|completed|upcoming|all] Task dates notify in-app. For timed alerts on any block: reminders --help.

craft_read

Write; prefer semicolon batches when inputs/IDs are known; split calls for result dependencies. docs blocks daily notes tasks todos folders collections tables schema items links files; add append update rename delete trash move reorder repeat folders create --name <name> [--parent <folderId>] documents create --title <requestedTitle> [--destination unsorted|templates | --folder <folderId>] tasks add --markdown <text> [--state todo|done|canceled] [--schedule <date>] [--deadline <date>] tasks update/delete --task <taskId> ... blocks add --id <pageId> --markdown <text> blocks add --siblingId <blockId> --markdown <text> [--position before|after] blocks update --id <blockId> --markdown <text> blocks delete --id <blockId> blocks move --id <blockId> --targetId <pageId> collections create --help collections rename --collection <collectionId> --name <name> collections schema-update --collection <collectionId> ... collections items-add --collection <collectionId> --<PropertyName> <value> collections items-update --collection <collectionId> --id <itemId> --<PropertyName> <value> collections items-delete --collection <collectionId> --id <itemId> collections views-create/update/delete/set-active --collection <collectionId> ... comments add --comments '[{"blockId":"blockId","content":"text"}]' whiteboards create [--position <json>]; whiteboards elements add/update/delete --whiteboard <whiteboardId> ... MD: Use actual newlines, not literal backslash-n; \n\n=blocks. Markdown changes text, formatting and task state. Wording-only: retain style/state via explicit fields; see command help. update:first replaces;rest inserts. IDs:resolve;rootBlockId!=URL docId. Date YYYY-MM-DD/today/tomorrow. Ext:<callout>,+ Toggle,> quote. Help: <entity> <action> --help Block reminders: reminders --help Task dates notify in-app. For timed alerts on any block: reminders --help.

craft_write

Write and show: executes the same commands as craft_write, applying changes immediately. Displays an interactive card: supported block edits show before/after differences and Undo/Redo when available; other changes show a summary. Includes a link to open the changed content in Craft. Default to craft_write. When using craft_write, prefer semicolon batches when inputs and IDs are known; split calls for result dependencies. Reserve craft_write_and_show for a single small edit, never batches, when the user requests a diff or visual review would meaningfully help. Use craft_write for help commands and routine edits. In your final response, link each changed document. You may omit the link only when editing a single document already explicitly identified in the last few turns. For multiple changed documents or a newly created document, always include links. Use craft_write_and_show INSTEAD OF craft_write, never repeat a completed write to show it. Not a read or preview tool. Block reminders: reminders --help Task dates notify in-app. For timed alerts on any block: reminders --help.

craft_write_and_show

Reverts a previous mutation if blocks haven't been modified since. Used by widgets for undo/redo functionality.

blocks_revert

Opens a file picker for the user to upload a file (image, PDF, etc.) to a specific position in a document. The user will drag-and-drop or select a file in the widget.

file_picker_open

Uploads a file from a temporary URL to a document position. Called by the file picker widget after the user selects a file.

file_upload_from_url