Bear Notes for Openclaw

A specialized tool for managing Bear notes on macOS through the grizzly CLI and x-callback-url integration.

steipete
v1.0.0
Jan 5, 2026
4
13.8k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install bear-notes

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install bear-notes using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Bear Notes?

This skill empowers developers and AI agents to interact directly with Bear, the premier Markdown note-taking application for macOS. By utilizing the grizzly CLI, Openclaw Skills can programmatically perform actions that usually require manual UI interaction, such as creating formatted notes, searching through tags, and appending content to existing entries. It serves as a bridge between the command line and your personal knowledge base.

The integration relies on Bear's x-callback-url scheme, allowing for secure and efficient data exchange. Whether you are building automated journaling workflows or technical documentation pipelines, this skill provides the necessary interface to keep your notes organized without leaving your development environment. By incorporating Openclaw Skills into your workflow, you unlock the ability to treat your notes as a programmable database.

Bear Notes Use Cases

  • Automatically capturing terminal output or logs into a dedicated Bear note for record-keeping.
  • Creating structured project templates or daily stand-up notes via Openclaw Skills.
  • Programmatically retrieving note content to provide context for AI-driven coding tasks.
  • Organizing research by automatically tagging and filing snippets into specific Bear categories.

How Bear Notes Works

  1. The skill receives a command (e.g., create, search, or append) via the grizzly CLI.
  2. Grizzly constructs an x-callback-url specific to the Bear app's API requirements.
  3. For data retrieval operations, the skill utilizes the --enable-callback flag to listen for a response from Bear.
  4. Bear processes the request locally on macOS and returns the result (such as a Note ID or note content).
  5. The skill parses the response, often in JSON format, to be used by the agent or the next step in a pipeline within Openclaw Skills.

Bear Notes Setup

First, ensure you have the Bear app installed and running on your Mac. Then, install the grizzly CLI tool using Go:

go install github.com/tylerwince/grizzly/cmd/grizzly@latest

To perform advanced operations like reading notes or listing tags, you must provide an API token. Retrieve this from Bear by going to Help > API Token > Copy Token, then save it to your configuration:

mkdir -p ~/.config/grizzly
echo "YOUR_TOKEN" > ~/.config/grizzly/token

Bear Notes Data Schema & Taxonomy

The skill manages data through Bear's internal schema, exposed via the grizzly interface. The following table highlights the primary data structures used within Openclaw Skills:

Object Key Fields Description
Note id, title, text The core document containing Markdown content.
Tag name Organizational labels used for filtering and searching notes.
Config token_file, timeout Settings for authentication and CLI behavior.
Callback json, success The structure of the data returned by Bear after an operation.

Bear Notes Advanced Features

  • Support for x-callback-url listeners to enable bidirectional communication between the CLI and Bear.
  • Dry-run mode to preview generated API URLs before execution.
  • JSON output formatting for easy parsing by other automation scripts and Openclaw Skills.
  • Flexible configuration hierarchy supporting CLI flags, environment variables, and TOML files.
  • Append and prepend modes for adding text to notes without overwriting existing content.

SKILL.md


Loading

METADATA

Github Stars: 0
forks: 0

Featured*