bear-notes
Create, search, and manage Bear notes via grizzly.
Setup & Installation
Install command
clawhub install steipete/bear-notesIf the CLI is not installed:
Install command
npx clawhub@latest install steipete/bear-notesOr install with OpenClaw CLI:
Install command
openclaw skills install steipete/bear-notesor paste the repo link into your assistant's chat
Install command
https://github.com/openclaw/skills/tree/main/skills/steipete/bear-notesWhat This Skill Does
Interacts with Bear notes on macOS through the grizzly CLI. Supports creating, reading, searching, and appending to notes using Bear's x-callback-url system. Bear must be running for any command to work.
Enables scripting and automation of Bear note management without touching the GUI, which is otherwise impossible with Bear alone.
When to Use It
- Create a tagged note from piped command output
- Append meeting summaries to an existing Bear note
- List all tags to audit note organization
- Search notes by tag and return structured JSON
- Read a specific note's content by its ID
View original SKILL.md file
# Bear Notes Use `grizzly` to create, read, and manage notes in Bear on macOS. Requirements - Bear app installed and running - For some operations (add-text, tags, open-note --selected), a Bear app token (stored in `~/.config/grizzly/token`) ## Getting a Bear Token For operations that require a token (add-text, tags, open-note --selected), you need an authentication token: 1. Open Bear → Help → API Token → Copy Token 2. Save it: `echo "YOUR_TOKEN" > ~/.config/grizzly/token` ## Common Commands Create a note ```bash echo "Note content here" | grizzly create --title "My Note" --tag work grizzly create --title "Quick Note" --tag inbox < /dev/null ``` Open/read a note by ID ```bash grizzly open-note --id "NOTE_ID" --enable-callback --json ``` Append text to a note ```bash echo "Additional content" | grizzly add-text --id "NOTE_ID" --mode append --token-file ~/.config/grizzly/token ``` List all tags ```bash grizzly tags --enable-callback --json --token-file ~/.config/grizzly/token ``` Search notes (via open-tag) ```bash grizzly open-tag --name "work" --enable-callback --json ``` ## Options Common flags: - `--dry-run` — Preview the URL without executing - `--print-url` — Show the x-callback-url - `--enable-callback` — Wait for Bear's response (needed for reading data) - `--json` — Output as JSON (when using callbacks) - `--token-file PATH` — Path to Bear API token file ## Configuration Grizzly reads config from (in priority order): 1. CLI flags 2. Environment variables (`GRIZZLY_TOKEN_FILE`, `GRIZZLY_CALLBACK_URL`, `GRIZZLY_TIMEOUT`) 3. `.grizzly.toml` in current directory 4. `~/.config/grizzly/config.toml` Example `~/.config/grizzly/config.toml`: ```toml token_file = "~/.config/grizzly/token" callback_url = "http://127.0.0.1:42123/success" timeout = "5s" ``` ## Notes - Bear must be running for commands to work - Note IDs are Bear's internal identifiers (visible in note info or via callbacks) - Use `--enable-callback` when you need to read data back from Bear - Some operations require a valid token (add-text, tags, open-note --selected)
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: Create a tagged note from piped command output
- 1Create a tagged note from piped command output
- 2Append meeting summaries to an existing Bear note
- 3List all tags to audit note organization
- 4Search notes by tag and return structured JSON
- 5Read a specific note's content by its ID
Create, search, and manage Bear notes via grizzly.
Security Audits
These signals reflect official OpenClaw status values. A Suspicious status means the skill should be used with extra caution.