drafts

What This Skill Does

The Drafts CLI skill provides a robust bridge between the macOS terminal and the powerful Drafts application. It enables OpenClaw AI agents to perform complex document management tasks, including creating, listing, searching, appending, and editing notes directly within the Drafts environment. By leveraging AppleScript, this skill automates the capture and organization of text, turning the Drafts app into a programmable knowledge base that can be controlled via natural language requests. It is ideal for users who rely on Drafts for quick capture and wish to extend that capability to their terminal or AI-integrated workflows.

Installation

To install this skill, use the command: clawhub install openclaw/skills/skills/nerveband/drafts. Ensure you have the Go language installed on your system if you intend to build from the provided source code, or simply use the provided binary instructions. Note that the Drafts application must be installed on your macOS system and you must have an active Drafts Pro subscription to utilize the underlying automation features.

Use Cases

• Automated Logging: Automatically append daily journal entries or meeting minutes to a specific draft without leaving your current workspace.
• Intelligent Inbox Management: Instruct the AI to list, search, and process items currently sitting in your Drafts inbox using natural language filters.
• Rapid Task Capture: Use the AI to quickly capture ideas, links, or to-do items into the Drafts ecosystem with specific tags, such as "#work" or "#shopping", for easier organization.
• Content Transformation: Trigger pre-defined Drafts actions, such as formatting text as Markdown, sending content to email, or copying text to the clipboard directly from the CLI.

Example Prompts

1. "Drafts: Create a new note with the title 'Project Ideas' and add the tags 'brainstorming' and 'work'."
2. "List all my drafts in the inbox that have the tag 'todo' and tell me what the latest one is."
3. "Append 'Follow up with the team regarding Q3 goals' to my 'Daily Notes' draft."

Tips & Limitations

• Requirements: This skill is strictly for macOS. The Drafts app must remain open for the automation to function correctly. If you experience hangs or errors, verify the application is running via open -a Drafts.
• Permissions: Ensure you have granted the terminal or the AI environment necessary Automation permissions under macOS System Settings to interact with Drafts.
• Pro Features: Many automation commands depend on Drafts Pro; free tier users may experience limited functionality.
• Performance: Because it utilizes AppleScript, commands are processed sequentially; avoid triggering high-volume batch updates simultaneously.