{"skill":{"slug":"drafts","displayName":"Drafts CLI","summary":"Manage Drafts app notes via CLI on macOS. Create, view, list, edit, append, prepend, and run actions on drafts. Use when a user asks to create a note, list drafts, search drafts, or manage their Drafts inbox. IMPORTANT - Drafts app must be running on macOS for this to work.","description":"---\nname: drafts\ndescription: Manage Drafts app notes via CLI on macOS. Create, view, list, edit, append, prepend, and run actions on drafts. Use when a user asks to create a note, list drafts, search drafts, or manage their Drafts inbox. IMPORTANT - Drafts app must be running on macOS for this to work.\nhomepage: https://github.com/nerveband/drafts\nmetadata: {\"clawdbot\":{\"emoji\":\"📋\",\"os\":[\"darwin\"],\"requires\":{\"bins\":[\"drafts\"]}}}\n---\n\n# Drafts CLI\n\nManage [Drafts](https://getdrafts.com) notes from the terminal on macOS.\n\n## IMPORTANT REQUIREMENTS\n\n> **This CLI ONLY works on macOS with Drafts app running.**\n\n- **macOS only** - Uses AppleScript, will not work on Linux/Windows\n- **Drafts must be RUNNING** - The app must be open for any command to work\n- **Drafts Pro required** - Automation features require Pro subscription\n\nIf commands fail or hang, first check: `open -a Drafts`\n\n## Setup\n\nInstall via Go:\n```bash\ngo install github.com/nerveband/drafts/cmd/drafts@latest\n```\n\nOr build from source:\n```bash\ngit clone https://github.com/nerveband/drafts\ncd drafts && go build ./cmd/drafts\n```\n\n## Commands\n\n### Create a Draft\n\n```bash\n# Simple draft\ndrafts create \"Meeting notes for Monday\"\n\n# With tags\ndrafts create \"Shopping list\" -t groceries -t todo\n\n# Flagged draft\ndrafts create \"Urgent reminder\" -f\n\n# Create in archive\ndrafts create \"Reference note\" -a\n```\n\n### List Drafts\n\n```bash\n# List inbox (default)\ndrafts list\n\n# List archived drafts\ndrafts list -f archive\n\n# List trashed drafts\ndrafts list -f trash\n\n# List all drafts\ndrafts list -f all\n\n# Filter by tag\ndrafts list -t mytag\n```\n\n### Get a Draft\n\n```bash\n# Get specific draft\ndrafts get <uuid>\n\n# Get active draft (currently open in Drafts)\ndrafts get\n```\n\n### Modify Drafts\n\n```bash\n# Prepend text\ndrafts prepend \"New first line\" -u <uuid>\n\n# Append text\ndrafts append \"Added at the end\" -u <uuid>\n\n# Replace entire content\ndrafts replace \"Completely new content\" -u <uuid>\n```\n\n### Edit in Editor\n\n```bash\ndrafts edit <uuid>\n```\n\n### Run Actions\n\n```bash\n# Run action on text\ndrafts run \"Copy\" \"Text to copy to clipboard\"\n\n# Run action on existing draft\ndrafts run \"Copy\" -u <uuid>\n```\n\n### Get Schema\n\n```bash\n# Full schema for LLM integration\ndrafts schema\n\n# Schema for specific command\ndrafts schema create\n```\n\n## Output Format\n\n**JSON (default)** - All commands return structured JSON:\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"uuid\": \"ABC123\",\n    \"content\": \"Note content\",\n    \"title\": \"Note title\",\n    \"tags\": [\"tag1\", \"tag2\"],\n    \"folder\": \"inbox\"\n  }\n}\n```\n\n**Plain text** - Human-readable output:\n```bash\ndrafts list --plain\n```\n\n## Common Workflows\n\n### Quick Capture\n```bash\ndrafts create \"Remember to call dentist tomorrow\" -t reminder\n```\n\n### Daily Journal\n```bash\ndrafts append \"$(date): Completed project review\" -u <journal-uuid>\n```\n\n### Search and Review\n```bash\n# List all drafts with a specific tag\ndrafts list -t work\n\n# Get full content of a draft\ndrafts get <uuid>\n```\n\n## Troubleshooting\n\n**Commands fail or return empty:**\n1. Is Drafts running? → `open -a Drafts`\n2. Is Drafts Pro active? → Automation requires Pro\n3. Permissions granted? → System Settings > Privacy > Automation\n\n**Commands hang:**\n- Check if Drafts is showing a dialog\n\n## Notes\n\n- macOS ONLY (AppleScript-based)\n- Drafts app MUST be running\n- Requires Drafts Pro subscription\n- All UUIDs are Drafts-generated identifiers\n- Tags are case-sensitive\n\n## Version\n\nLatest (from go install)\n","tags":{"latest":"1.0.0"},"stats":{"comments":0,"downloads":2503,"installsAllTime":4,"installsCurrent":4,"stars":1,"versions":1},"createdAt":1769484534436,"updatedAt":1778485857338},"latestVersion":{"version":"1.0.0","createdAt":1769484534436,"changelog":"Full Drafts app integration","license":null},"metadata":{"setup":[],"os":["darwin"],"systems":null},"owner":{"handle":"nerveband","userId":"s178bntdwxfdp84tyapwnpt3y1885rpz","displayName":"nerveband","image":"https://avatars.githubusercontent.com/u/1530727?v=4"},"moderation":null}