Drafts CLI
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 Draft
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 Draft
Real data. Real impact.
Growing
Developers
Per week
Open source
Skills give you superpowers. Install in 30 seconds.
Manage Drafts notes from the terminal on macOS.
This CLI ONLY works on macOS with Drafts app running.
If commands fail or hang, first check:
open -a Drafts
Install via Go:
go install github.com/nerveband/drafts/cmd/drafts@latest
Or build from source:
git clone https://github.com/nerveband/drafts cd drafts && go build ./cmd/drafts
# Simple draft drafts create "Meeting notes for Monday"With tags
drafts create "Shopping list" -t groceries -t todo
Flagged draft
drafts create "Urgent reminder" -f
Create in archive
drafts create "Reference note" -a
# List inbox (default) drafts listList archived drafts
drafts list -f archive
List trashed drafts
drafts list -f trash
List all drafts
drafts list -f all
Filter by tag
drafts list -t mytag
# Get specific draft drafts get <uuid>Get active draft (currently open in Drafts)
drafts get
# Prepend text drafts prepend "New first line" -u <uuid>Append text
drafts append "Added at the end" -u <uuid>
Replace entire content
drafts replace "Completely new content" -u <uuid>
drafts edit <uuid>
# Run action on text drafts run "Copy" "Text to copy to clipboard"Run action on existing draft
drafts run "Copy" -u <uuid>
# Full schema for LLM integration drafts schemaSchema for specific command
drafts schema create
JSON (default) - All commands return structured JSON:
{ "success": true, "data": { "uuid": "ABC123", "content": "Note content", "title": "Note title", "tags": ["tag1", "tag2"], "folder": "inbox" } }
Plain text - Human-readable output:
drafts list --plain
drafts create "Remember to call dentist tomorrow" -t reminder
drafts append "$(date): Completed project review" -u <journal-uuid>
# List all drafts with a specific tag drafts list -t workGet full content of a draft
drafts get <uuid>
Commands fail or return empty:
open -a DraftsCommands hang:
Latest (from go install)
No automatic installation available. Please visit the source repository for installation instructions.
View Installation Instructions1,500+ AI skills, agents & workflows. Install in 30 seconds. Part of the Torly.ai family.
© 2026 Torly.ai. All rights reserved.