bear-notes
Create, search, and manage Bear notes via grizzly CLI.
Security Assessment
About bear-notes
The bear-notes skill provides command-line access to Bear, a popular note-taking application for macOS. It uses the grizzly CLI tool to interact with Bear's x-callback-url API, enabling users to create, search, read, and manage their Bear notes directly from the terminal without switching to the GUI. This integration is particularly valuable for developers and power users who prefer keyboard-driven workflows and want to incorporate note-taking into their command-line automation scripts.
The skill supports core Bear operations including creating notes with titles and tags, opening existing notes by ID, appending content to notes, listing all available tags, and searching notes by tag name. It leverages Bear's callback mechanism to retrieve data from the app, with JSON output support for easy parsing in scripts. The grizzly tool handles the complexity of constructing proper x-callback-urls and managing authentication tokens, providing a clean command-line interface with options for dry-run previews and URL inspection.
This skill is ideal for developers who maintain technical documentation in Bear, content creators who want to automate their note-taking workflows, and anyone who prefers terminal-based productivity tools. Common use cases include capturing code snippets and research findings from the command line, batch-processing notes with tags for organization, creating notes from script outputs or log files, and integrating Bear into larger automation pipelines. The skill requires Bear to be installed and running on macOS, with optional token-based authentication for operations that modify notes or access certain data.
FAQ
Do I need a Bear API token for all operations?
No, only certain operations require a token. Basic operations like creating notes and searching by tag work without a token. However, operations like add-text (appending to notes), listing tags, and open-note with --selected flag require a valid Bear API token stored in ~/.config/grizzly/token.
How do I find a note's ID to use with commands like open-note or add-text?
Note IDs are Bear's internal identifiers. You can obtain them by using commands with --enable-callback and --json flags, which return note data including IDs. Alternatively, you can find note IDs in Bear's note info panel within the app itself.
Can I use this skill on Windows or Linux?
No, this skill only works on macOS (darwin) because Bear is a macOS-exclusive application. Both Bear and the grizzly CLI tool require macOS to function.
What's the difference between --enable-callback and regular command execution?
The --enable-callback flag tells grizzly to wait for Bear's response and retrieve data back from the app. This is essential for operations that read data (like getting note content or listing tags). Without this flag, commands execute fire-and-forget style without returning Bear's response.
How do I install the grizzly CLI tool?
Install grizzly using Go: go install github.com/tylerwince/grizzly/cmd/grizzly@latest. You need Go installed on your system. After installation, ensure the Go bin directory is in your PATH.
Install bear-notes
Quick Setup:
- Copy the skill folder to
.claude/skills/ - Claude will automatically detect and use the skill
Repository
steipete/clawdis