Changelog

• 9943186 feat: add comprehensive LLM styling reference and craft llm styles command
• 23f8565 merge json-parity into main

Changelog

• ae04645 feat: add collection API client methods with tests
• 8931e5c feat: add collections, connection, upload, and comments commands
• daaaa84 feat: add compact output format for legacy views
• 72d49f4 feat: add connection, upload, comments, block search, advanced search/list API methods
• 228ca09 feat: add models for collections, connection, upload, comments, block search
• e27cad8 feat: default json outputs full api payloads
• 4a9eb16 feat: enhance search, blocks, and list with advanced filters, block search, daily notes
• 4a29ca2 fix: align create json output with api
• a380aec fix: honor compact format in json paths
• f199444 v1.7.0: Full API parity - collections, upload, block search, advanced filters

What's New

Full parity with the Craft Space API. Every documented endpoint is now accessible from the CLI.

New Commands

• craft collections — List, view schema, and manage collection items (add/update/delete)
• craft connection — Show space metadata (timezone, deep link templates)
• craft upload — Upload files and images to documents or daily notes
• craft comments add — Add comments to blocks (experimental API)

Enhanced Commands

• craft search — Block-level search within documents (--document), regex (--regex), date filters, location/folder filters, context blocks
• craft blocks get — Daily note access (--date today), depth control (--depth), metadata (--metadata)
• craft blocks add — Add blocks to daily notes by date (--date)
• craft list — Date range filters (--created-after, --modified-before, etc.), metadata fetching

API Coverage

• 9 new API endpoint integrations
• 4 new command files, 3 enhanced commands
• ~2,700 lines of new code with full test coverage

Install

# macOS (Apple Silicon)
curl -L https://github.com/nerveband/craft-cli/releases/download/v1.7.0/craft-darwin-arm64 -o /usr/local/bin/craft && chmod +x /usr/local/bin/craft

# macOS (Intel)
curl -L https://github.com/nerveband/craft-cli/releases/download/v1.7.0/craft-darwin-amd64 -o /usr/local/bin/craft && chmod +x /usr/local/bin/craft

# Or build from source
go install github.com/ashrafali/craft-cli@v1.7.0

What's New

This release achieves full feature parity with the Craft MCP server, adding rich block styling support and new management commands.

New Output Formats

New Commands

Folder Management:

• craft folders list - List all folders
• craft folders create - Create a folder
• craft folders move - Move folder to new parent
• craft folders delete - Delete a folder

Block Operations:

• craft blocks get - Get a specific block with full metadata
• craft blocks add - Add block with position control (start/end/before/after)
• craft blocks update - Update block content
• craft blocks delete - Delete a block
• craft blocks move - Move block to new location

Task Management:

• craft tasks list - List tasks with scope and document filters
• craft tasks add - Create task with scheduling and deadlines
• craft tasks update - Update task state or dates
• craft tasks delete - Delete a task

Document Operations:

• craft move - Move document to folder or location (unsorted/trash)

Enhanced Commands

• craft list --folder ID - Filter documents by folder
• craft list --location unsorted|trash|templates|daily_notes - Filter by location
• craft get --format structured|craft|rich - New output formats

Block Styling Support

The CLI now captures all block styling properties:

• cardLayout: small, regular, large
• font: system, serif, mono, rounded
• decorations: callout, quote (combinable)
• color: Hex colors (#RRGGBB)
• listStyle: bullet, numbered, task, toggle
• taskInfo: state, scheduleDate, deadlineDate
• indentationLevel: 0-5
• lineStyle: strong, regular, light, extraLight
• Table cells with text attributes

Installation

# macOS/Linux
brew install nerveband/tap/craft-cli

# Or download from releases

Changelog

• 46653ad v1.5.0: Auto-update notifications and LLM upgrade guidance

Changelog

• 0205b0a Reduce demo.gif size from 10MB to 5MB
• 26db1ef v1.3.0: Add API key authentication and large document support
• f1f52e8 v1.4.0: Enhanced documentation and discoverability

What's Changed

Bug Fixes

• Fixed craft get command - now uses correct /blocks?id= endpoint instead of /documents/{id}
• Fixed craft search command - now uses include parameter instead of query
• Fixed craft create command - properly wraps request in {"documents":[...]} format

New Features

• craft update now works! - Adds content to existing documents via the blocks API
• craft delete now works! - Removes content blocks from documents

Technical Changes

• Added Block and BlocksResponse models for blocks API
• Added SearchItem model for search results
• Updated all tests for new API behavior

Notes

• Title updates via CLI are not supported by Craft Connect API (use Craft app)
• Document deletion removes content blocks only (root page blocks cannot be deleted via API)

Installation

Download the binary for your platform and add it to your PATH:

• macOS (Apple Silicon): craft-darwin-arm64
• macOS (Intel): craft-darwin-amd64
• Linux (x64): craft-linux-amd64
• Linux (ARM64): craft-linux-arm64
• Windows: craft-windows-amd64.exe

Changelog

• 1f08300 Add API link patterns to gitignore
• aa993cd Add project summary
• 6118595 Add test results and installation guide
• 080aee5 Fix redundant newline in fmt.Println
• 2499b9f Initial commit: Production-ready Craft CLI v1.0.0
• 4e58964 Remove private API links from test results
• 29b9af2 Update go.mod dependencies
• 2219ec0 Update go.mod/go.sum dependencies
• 1f397aa v1.0.0: Initial public release
• da78d1b v2.0.0: Major feature release