# Bear Notes

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

- Repository: https://github.com/OpenBMB/PilotDeck (4947 stars)
- Category: Writing
- License: AGPL-3.0
- Last updated: 2026-10-29
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add OpenBMB/PilotDeck --skill bear-notes -g -a claude-code -y`
Codex: `npx skills add OpenBMB/PilotDeck --skill bear-notes -g -a codex -y`
Cursor: `npx skills add OpenBMB/PilotDeck --skill bear-notes -g -a cursor -y`
Gemini CLI: `npx skills add OpenBMB/PilotDeck --skill bear-notes -g -a gemini-cli -y`

## Description

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

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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

The rest: https://github.com/OpenBMB/PilotDeck/blob/HEAD/skills/bear-notes/SKILL.md