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