---

name: craft description: Manage Craft notes, documents, and tasks via CLI. Use when the user asks to add notes, create documents, manage tasks, search their Craft documents, or work with daily notes. Craft is a note-taking app for macOS/iOS. metadata: {"clawdbot":{"install":[{"id":"craft-cli","kind":"script","path":"scripts/craft","dest":"~/bin/craft","label":"Install Craft CLI"}]}}

Craft CLI

Interact with Craft.do documents, blocks, and tasks.

Setup

1. Install: Copy scripts/craft to ~/bin/craft and make executable
2. Get API URL from Craft: Settings > Integrations > Craft Connect > Create Link
3. Set env var: export CRAFT_API_URL='https://connect.craft.do/links/YOUR_LINK/api/v1'

Add to shell profile for persistence.

Commands

Documents

craft folders                    # List all folders
craft docs [location]            # List documents (unsorted, trash, templates, daily_notes)
craft doc <id>                   # Get document content by ID
craft daily [date]               # Get daily note (today, yesterday, YYYY-MM-DD)
craft search <term>              # Search across documents
craft create-doc "Title" [folderId]  # Create new document

Blocks

craft add-block <docId> "markdown"      # Add block to document
craft add-to-daily "markdown" [date]    # Add to daily note (default: today)
craft update-block <blockId> "markdown" # Update existing block
craft delete-block <blockId>...         # Delete block(s)

Tasks

craft tasks [scope]              # List tasks (inbox, active, upcoming, logbook)
craft add-task "text" [scheduleDate]  # Add task to inbox
craft complete-task <id>         # Mark task as done
craft delete-task <id>           # Delete task

Collections

craft collections                # List all collections
craft collection-items <id>      # Get items from collection

Notes

• Markdown content passed as arguments; escape quotes if needed
• Dates: today, yesterday, or YYYY-MM-DD
• Task scopes: inbox (default), active, upcoming, logbook
• Document locations: unsorted, trash, templates, daily_notes