Bear Notes 是一个基于 grizzly CLI 的命令行技能,用于在 macOS 上创建、读取和管理 Bear 应用中的笔记。
用途
通过命令行对 Bear 笔记进行创建、读取和管理操作,适合在终端或自动化流程中处理 Bear 笔记。
前提条件
需要安装并运行 Bear 应用。
部分操作(add-text、tags、open-note --selected)需要 Bear 应用 token,该 token 存储于 ~/.config/grizzly/token。
获取 Bear Token
对于需要 token 的操作(add-text、tags、open-note --selected),需要身份验证 token:
打开 Bear → Help → API Token → Copy Token
保存 token:echo "YOUR_TOKEN" > ~/.config/grizzly/token
主要能力与常用命令
创建笔记:
echo "Note content here" | grizzly create --title "My Note" --tag work
grizzly create --title "Quick Note" --tag inbox < /dev/null
按 ID 打开/读取笔记:
grizzly open-note --id "NOTE_ID" --enable-callback --json
向笔记追加文本:
echo "Additional content" | grizzly add-text --id "NOTE_ID" --mode append --token-file ~/.config/grizzly/token
列出所有标签:
grizzly tags --enable-callback --json --token-file ~/.config/grizzly/token
搜索笔记(通过 open-tag):
grizzly open-tag --name "work" --enable-callback --json
选项说明
常用标志:
--dry-run — 预览 URL 而不执行
--print-url — 显示 x-callback-url
--enable-callback — 等待 Bear 的响应(读取数据时需要)
--json — 以 JSON 输出(使用回调时)
--token-file PATH — Bear API token 文件路径
配置
Grizzly 按以下优先级读取配置:
CLI 标志
环境变量(GRIZZLY_TOKEN_FILE、GRIZZLY_CALLBACK_URL、GRIZZLY_TIMEOUT)
当前目录下的 .grizzly.toml
~/.config/grizzly/config.toml
~/.config/grizzly/config.toml 示例:
token_file = "~/.config/grizzly/token" callback_url = "http://127.0.0.1:42123/success" timeout = "5s"
使用限制与注意事项
必须运行 Bear 应用,命令才能工作。
笔记 ID 是 Bear 的内部标识符(可在笔记信息中查看或通过回调获取)。
需要从 Bear 读回数据时,使用 --enable-callback。
部分操作需要有效 token(add-text、tags、open-note --selected)。