bear-notes

star 51

Create, search, and manage Bear notes via grizzly CLI.

NJX-njx By NJX-njx schedule Updated 2/13/2026

name: bear-notes description: Create, search, and manage Bear notes via grizzly CLI. homepage: https://bear.app metadata: { "opensoul": { "emoji": "๐Ÿป", "os": ["darwin"], "requires": { "bins": ["grizzly"] }, "install": [ { "id": "go", "kind": "go", "module": "github.com/tylerwince/grizzly/cmd/grizzly@latest", "bins": ["grizzly"], "label": "Install grizzly (go)", }, ], },

}

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/null

Open/read a note by ID

grizzly open-note --id "NOTE_ID" --enable-callback --json

Append text to a note

echo "Additional content" | grizzly add-text --id "NOTE_ID" --mode append --token-file ~/.config/grizzly/token

List all tags

grizzly tags --enable-callback --json --token-file ~/.config/grizzly/token

Search notes (via open-tag)

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:

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)
Install via CLI
npx skills add https://github.com/NJX-njx/opensoul --skill bear-notes
Repository Details
star Stars 51
call_split Forks 5
navigation Branch main
article Path SKILL.md
More from Creator