bear-notes

This skill uses grizzly, a Go-based CLI tool that communicates with Bear via its x-callback-url API. When your agent issues a command, grizzly constructs the appropriate Bear URL scheme call and waits for Bear's response (when --enable-callback is used).Agent issues a command — e.g., create a note, read by ID, or append text.grizzly translates it — into a Bear x-callback-url request.Bear executes and responds — returning data as JSON when callbacks are enabled.Agent receives structured output — note content, IDs, tags, and more.For token-gated operations (adding text, listing tags, reading selected notes), grizzly reads a Bear API token from ~/.config/grizzly/token or a path you specify.

Create Notes — Create new Bear notes with a title, content piped via stdin, and one or more tags.Read Notes by ID — Open and retrieve note content using Bear's internal note IDs, with JSON output support.Append Text — Add content to existing notes in append (or other) mode using a Bear API token.List & Browse Tags — Retrieve all tags in your Bear library as structured JSON.Search by Tag — Open and list notes under a specific tag using open-tag.Dry-run & Debug Flags — Preview x-callback-urls before executing with --dry-run and --print-url.Flexible Configuration — Configure via CLI flags, environment variables, or TOML config files.

Bear App (macOS) — Bear must be installed and running for all commands. Bear is a macOS-only application; this skill does not work on Linux or Windows.Bear API Token (optional for some operations) — Required for add-text, listing tags, and reading the currently selected note. Obtain it from Bear → Help → API Token → Copy Token, then save it to ~/.config/grizzly/token. Not needed for basic note creation or opening notes by ID.

Automated Note Capture — Have your agent automatically save research summaries, meeting notes, or web content directly into Bear with appropriate tags.Incremental Note Building — Append new findings or updates to an existing Bear note over time, keeping a running log without overwriting previous content.Tag-Based Knowledge Retrieval — Let your agent browse your Bear tag library and pull notes from a specific topic area for context or summarization.Personal CRM or Inbox Management — Use Bear as a lightweight inbox, with your agent creating and organizing incoming items under designated tags like inbox or action.