- 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
- Install: Copy
scripts/craftto~/bin/craftand make executable - Get API URL from Craft: Settings > Integrations > Craft Connect > Create Link
- 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 documentBlocks
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 taskCollections
craft collections # List all collections
craft collection-items <id> # Get items from collectionNotes
- Markdown content passed as arguments; escape quotes if needed
- Dates:
today,yesterday, orYYYY-MM-DD - Task scopes:
inbox(default),active,upcoming,logbook - Document locations:
unsorted,trash,templates,daily_notes