craft

# 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 ```bash 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 ```bash 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 ```bash 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 ```bash 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`