workspace

name	workspace
version	0.3.0
description	Browse and read Craft.do workspace documents. Use when the user asks to "read a Craft doc", "search Craft for X", "list Craft folders", "show recent Craft docs", "check today's Craft daily note", or references a Craft doc ID.

Browse and read documents in the Craft.do workspace via the craft CLI.

Finding documents

Start with craft folders to see the workspace structure, then narrow down with craft docs --folder NAME or craft search "query" for content search. Use craft recent to see what changed lately.

Reading content

craft read <docId> returns a doc as markdown. Add --meta for created/modified timestamps. To search within a specific doc, use craft search "pattern" --doc <docId>.

Commands

The craft binary is at: ${CLAUDE_PLUGIN_ROOT}/bin/craft

Always use this full path when running craft via Bash. Do not assume craft is on PATH.

• folders -- list folder tree
• docs --folder NAME -- list docs in a folder
• recent -- recently modified docs
• search "pattern" -- content search across all docs
• search "query" --title -- match doc titles only
• search "pattern" --doc <docId> -- search within a specific doc
• read <docId> -- read doc as markdown
• read <docId> --meta -- with timestamps
• today -- today's daily note
• tasks -- active tasks

All commands accept --json for raw API output.

Environment

Requires CRAFT_API_KEY and CRAFT_API_BASE in the shell environment.