$npx -y skills add SafeAI-Lab-X/ClawKeeper --skill bear-notesCreate, search, and manage Bear notes via grizzly CLI.
| 1 | # Bear Notes |
| 2 | |
| 3 | Use `grizzly` to create, read, and manage notes in Bear on macOS. |
| 4 | |
| 5 | Requirements |
| 6 | |
| 7 | - Bear app installed and running |
| 8 | - For some operations (add-text, tags, open-note --selected), a Bear app token (stored in `~/.config/grizzly/token`) |
| 9 | |
| 10 | ## Getting a Bear Token |
| 11 | |
| 12 | For operations that require a token (add-text, tags, open-note --selected), you need an authentication token: |
| 13 | |
| 14 | 1. Open Bear → Help → API Token → Copy Token |
| 15 | 2. Save it: `echo "YOUR_TOKEN" > ~/.config/grizzly/token` |
| 16 | |
| 17 | ## Common Commands |
| 18 | |
| 19 | Create a note |
| 20 | |
| 21 | ```bash |
| 22 | echo "Note content here" | grizzly create --title "My Note" --tag work |
| 23 | grizzly create --title "Quick Note" --tag inbox < /dev/null |
| 24 | ``` |
| 25 | |
| 26 | Open/read a note by ID |
| 27 | |
| 28 | ```bash |
| 29 | grizzly open-note --id "NOTE_ID" --enable-callback --json |
| 30 | ``` |
| 31 | |
| 32 | Append text to a note |
| 33 | |
| 34 | ```bash |
| 35 | echo "Additional content" | grizzly add-text --id "NOTE_ID" --mode append --token-file ~/.config/grizzly/token |
| 36 | ``` |
| 37 | |
| 38 | List all tags |
| 39 | |
| 40 | ```bash |
| 41 | grizzly tags --enable-callback --json --token-file ~/.config/grizzly/token |
| 42 | ``` |
| 43 | |
| 44 | Search notes (via open-tag) |
| 45 | |
| 46 | ```bash |
| 47 | grizzly open-tag --name "work" --enable-callback --json |
| 48 | ``` |
| 49 | |
| 50 | ## Options |
| 51 | |
| 52 | Common flags: |
| 53 | |
| 54 | - `--dry-run` — Preview the URL without executing |
| 55 | - `--print-url` — Show the x-callback-url |
| 56 | - `--enable-callback` — Wait for Bear's response (needed for reading data) |
| 57 | - `--json` — Output as JSON (when using callbacks) |
| 58 | - `--token-file PATH` — Path to Bear API token file |
| 59 | |
| 60 | ## Configuration |
| 61 | |
| 62 | Grizzly reads config from (in priority order): |
| 63 | |
| 64 | 1. CLI flags |
| 65 | 2. Environment variables (`GRIZZLY_TOKEN_FILE`, `GRIZZLY_CALLBACK_URL`, `GRIZZLY_TIMEOUT`) |
| 66 | 3. `.grizzly.toml` in current directory |
| 67 | 4. `~/.config/grizzly/config.toml` |
| 68 | |
| 69 | Example `~/.config/grizzly/config.toml`: |
| 70 | |
| 71 | ```toml |
| 72 | token_file = "~/.config/grizzly/token" |
| 73 | callback_url = "http://127.0.0.1:42123/success" |
| 74 | timeout = "5s" |
| 75 | ``` |
| 76 | |
| 77 | ## Notes |
| 78 | |
| 79 | - Bear must be running for commands to work |
| 80 | - Note IDs are Bear's internal identifiers (visible in note info or via callbacks) |
| 81 | - Use `--enable-callback` when you need to read data back from Bear |
| 82 | - Some operations require a valid token (add-text, tags, open-note --selected) |