Craft Notes
by @noah-ribaudo
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.
clawhub install craftπ About This Skill
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 # Get document content by ID
craft daily [date] # Get daily note (today, yesterday, YYYY-MM-DD)
craft search # Search across documents
craft create-doc "Title" [folderId] # Create new document
Blocks
craft add-block "markdown" # Add block to document
craft add-to-daily "markdown" [date] # Add to daily note (default: today)
craft update-block "markdown" # Update existing block
craft delete-block ... # 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 # Mark task as done
craft delete-task # Delete task
Collections
craft collections # List all collections
craft collection-items # Get items from collection
Notes
today, yesterday, or YYYY-MM-DDinbox (default), active, upcoming, logbookunsorted, trash, templates, daily_notesβοΈ Configuration
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.
π Tips & Best Practices
today, yesterday, or YYYY-MM-DDinbox (default), active, upcoming, logbookunsorted, trash, templates, daily_notes