apple-notes

What This Skill Does

The apple-notes skill empowers you to manage your Apple Notes directly from your terminal on macOS. Leveraging the memo CLI tool, this skill allows for seamless creation, viewing, editing, deletion, searching, moving notes between folders, and exporting them to HTML or Markdown formats. It acts as a powerful bridge between your command-line workflow and the native Apple Notes application, enhancing productivity for users who prefer terminal-based interactions.

Installation

To install the apple-notes skill, you'll need to use the clawhub command. Open your terminal and run the following command:

clawhub install openclaw/openclaw/skills/apple-notes

This command will download and set up the skill. For the memo CLI itself to function, you may need to install it separately. The recommended method is using Homebrew: brew tap antoniorodr/memo && brew install antoniorodr/memo/memo. Alternatively, you can install it via pip after cloning the repository: pip install ..

Important Note: This skill is macOS-only. You might be prompted to grant Automation access to the Notes.app; please grant this permission for the skill to function correctly. For automation purposes, ensure Notes.app has the necessary permissions in System Settings > Privacy & Security > Automation.

Use Cases

This skill is ideal for macOS users who want to integrate their note-taking workflow with their command-line operations.

• Quick Note Taking: Jot down ideas, to-do items, or important information without leaving your terminal.
• Information Retrieval: Quickly search for specific notes or list notes within particular folders.
• Note Organization: Move notes between different folders to maintain a structured system.
• Data Export: Export notes for use in other applications or for archival purposes.
• Developer Productivity: Developers can use this to quickly log code snippets, command references, or meeting notes without switching contexts.

Example Prompts

1. "Add a new note about the meeting with the marketing team."
2. "Show me all notes related to project Alpha."
3. "List my notes from the 'Work' folder."

Tips & Limitations

• macOS Only: This skill is designed exclusively for macOS.
• Notes.app Dependency: The skill requires Apple Notes.app to be installed and accessible.
• Permissions: Ensure you grant Automation access to Notes.app when prompted or through System Settings.
• No Image/Attachment Editing: The skill cannot currently edit notes that contain images or other attachments. Attempting to edit such notes may lead to unexpected behavior or errors.
• Interactive Prompts: Some operations, like selecting a note to edit or delete, rely on interactive prompts that require terminal access. Ensure your terminal environment supports these interactions.
• Export Format: Exports are generated in HTML or Markdown. The skill uses Mistune for Markdown processing.