bear-notes

What This Skill Does

The bear-notes skill provides a bridge between the OpenClaw agent and the Bear application on macOS. Utilizing the grizzly CLI, this skill enables programmatic management of notes, allowing users to create, search, and modify their Bear library without manual navigation. Whether you need to append data to an existing file, query tags, or open specific notes by ID, this skill exposes the functionality via an interface that respects Bear's x-callback-url protocol.

Installation

To integrate bear-notes into your agent, use the following command in your terminal:

clawhub install openclaw/skills/skills/steipete/bear-notes

Ensure that the Bear application is installed and currently running on your system. Because some operations require higher-privileged access to the Bear API, you must generate an API token from within the Bear app (Help → API Token) and store it securely. We recommend creating the file at ~/.config/grizzly/token. You can verify your configuration by running a simple tag query after installation to ensure authentication is correctly set up.

Use Cases

This skill is designed for power users who want to automate their personal knowledge base. Common use cases include:

• Automated Logging: Appending daily task summaries or terminal output directly to a "Daily Journal" note.
• Content Management: Programmatically tagging notes based on their content, such as adding a 'work' tag to notes generated from coding sessions.
• Search and Retrieval: Quickly surfacing specific notes or tagged collections via the command line, which can then be displayed in the Bear UI automatically via x-callback integration.
• Quick Capturing: Creating new notes with specific titles and tags via simple CLI piping or shell script execution.

Example Prompts

1. "Create a new note in Bear titled 'Project Brainstorm' with the tag 'ideas' and include the content: 'Review the quarterly goals.'"
2. "Search for all notes under the tag 'work' and display the contents of the most recent one."
3. "Append the current weather and my daily to-do list to the note with ID 8C3A-4F21."

Tips & Limitations

• Token Dependency: Most read/write operations require the API token. Always check that the ~/.config/grizzly/token file exists if commands fail.
• Execution Environment: Bear must be open for these commands to resolve correctly, as the CLI triggers internal app events.
• ID Management: Note IDs are specific to the Bear database. You can retrieve these by querying via the CLI with the --json flag enabled to extract the ID from the output.
• Dry Runs: If you are testing a script, use the --dry-run flag to see the x-callback URL that will be executed without triggering an actual change in Bear.