Skip to content

SKILL.md

Latest commit

 

History

History
62 lines (46 loc) · 2.1 KB

SKILL.md

File metadata and controls

62 lines (46 loc) · 2.1 KB
name description metadata
craft
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.
clawdbot
install
id kind path dest label
craft-cli
script
scripts/craft
~/bin/craft
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