Bear Notes
- 3k installs
- 385k repo stars
- Updated August 3, 2026
- steipete/clawdis
bear-notes is a macOS skill for creating and managing Bear notes via the grizzly CLI and Bear x-callback URLs.
About
Bear Notes integrates with the Bear app on macOS through the grizzly CLI for creating, reading, searching, and tagging notes. Requirements include Bear installed and running, with grizzly installable via Go module github.com/tylerwince/grizzly/cmd/grizzly. Token-requiring operations such as add-text, tags, and open-note --selected need a Bear API token from Help, API Token, saved to ~/.config/grizzly/token. Common commands pipe content into grizzly create with title and tag flags, open-note with enable-callback and json for reads, add-text with append mode, tags listing, and open-tag search by tag name. Configuration resolves from CLI flags, environment variables like GRIZZLY_TOKEN_FILE, local .grizzly.toml, or ~/.config/grizzly/config.toml with callback URL and timeout defaults. Dry-run and print-url flags preview x-callback-url actions without executing. Bear must stay running and note IDs come from Bear callbacks when reading data back into scripts or agents.
- grizzly CLI create, open-note, add-text, and tag commands.
- Bear API token required for add-text and tag listing operations.
- enable-callback and json flags for reading note data back.
- Config via grizzly.toml, env vars, or token file paths.
- macOS-only with Bear app running requirement.
Bear Notes by the numbers
- 2,988 all-time installs (skills.sh)
- +160 installs in the week ending Aug 2, 2026 (Skillselion tracking)
- Ranked #182 of 3,280 Productivity & Planning skills by installs in the Skillselion catalog
- Security screen: MEDIUM risk (skills.sh audit)
- Data as of Aug 3, 2026 (Skillselion catalog sync)
bear-notes capabilities & compatibility
- Capabilities
- note creation with title and tags · note read via open note callbacks · append text with token auth · tag listing and tag based search · dry run and print url preview modes · toml and env based grizzly configuration
- Use cases
- documentation · project management
- Platforms
- macOS
- Pricing
- Free
What bear-notes says it does
Bear must be running for commands to work
echo "Note content here" | grizzly create --title "My Note" --tag work
grizzly open-note --id "NOTE_ID" --enable-callback --json
npx skills add https://github.com/steipete/clawdis --skill bear-notesAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 3k |
|---|---|
| repo stars | ★ 385k |
| Security audit | 3 / 3 scanners passed |
| Last updated | August 3, 2026 |
| Repository | steipete/clawdis ↗ |
How do I create, append, and search Bear notes from the command line or an agent?
Create, search, and manage Bear notes on macOS using the grizzly CLI with optional Bear API tokens.
Who is it for?
macOS users who keep notes in Bear and want CLI or agent-driven note workflows.
Skip if: Skip for Windows or Linux note apps, Obsidian vault workflows, or server-side note hosting.
When should I use this skill?
User creates Bear notes, searches by tag, or appends content via grizzly on macOS.
What you get
Created or updated Bear note, tag listing, or tag-filtered note retrieval via grizzly callbacks.
- Bear notes created or updated
- Search results from Bear library
By the numbers
- OpenClaw metadata requires 1 binary: grizzly
- Targets macOS only (os: darwin)
Files
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
echo "Note content here" | grizzly create --title "My Note" --tag work
grizzly create --title "Quick Note" --tag inbox < /dev/nullOpen/read a note by ID
grizzly open-note --id "NOTE_ID" --enable-callback --jsonAppend text to a note
echo "Additional content" | grizzly add-text --id "NOTE_ID" --mode append --token-file ~/.config/grizzly/tokenList all tags
grizzly tags --enable-callback --json --token-file ~/.config/grizzly/tokenSearch notes (via open-tag)
grizzly open-tag --name "work" --enable-callback --jsonOptions
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:
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-callbackwhen you need to read data back from Bear - Some operations require a valid token (add-text, tags, open-note --selected)
Related skills
Grill MeHave an agent relentlessly pressure-test their plan or design until every decision branch is resolved and shared understanding is reached.691k196kGrill With DocsPressure-test architecture decisions against their live codebase and living documentation before writing production code.585k196k
Lark CalendarLet their coding agents read, create, and manage events inside Lark (Feishu) Calendar directly from natural language instructions.493kLark ImLet their coding agent send instant notifications, post updates, and receive commands directly inside Lark (Feishu) workspaces.493kLark ContactLet their AI coding agents read and write contacts, send messages, and manage user data inside Lark (Feishu).493kLark AttendanceAutomatically fetch and report daily attendance data from Lark (Feishu) into their own tools or agents.493kForks & variants (3)
Bear Notes has 3 known copies in the catalog totaling 29 installs. They canonicalize to this original listing.
- beita6969 - 16 installs
- sundial-org - 12 installs
- letta-ai - 1 installs
How it compares
Choose bear-notes over generic markdown note skills when the developer already stores knowledge in Bear and needs grizzly-backed terminal access.
FAQ
Where get the Bear API token?
Bear Help, API Token, Copy Token, then save to ~/.config/grizzly/token.
Why use --enable-callback?
It waits for Bear's response so you can read note content or tags as JSON.
Does Bear need to be open?
Yes. Bear must be running for grizzly commands to succeed.
Is Bear Notes safe to install?
skills.sh reports 3 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.