Bear Notes 技能的核心用途是借助 grizzly 命令行工具,在 macOS 上对 Bear 应用中的笔记进行创建、读取和管理。它适用于需要以命令行方式自动化操作 Bear 笔记的场景。
主要能力包括:创建笔记、按 ID 打开或读取笔记、向已有笔记追加文本、列出所有标签,以及通过打开标签来搜索笔记。
使用方式基于 grizzly 命令。创建笔记时,可将内容通过管道传入,例如 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。搜索笔记则通过 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 令牌文件路径。
grizzly 的配置读取优先级为:命令行标志、环境变量(GRIZZLY_TOKEN_FILE、GRIZZLY_CALLBACK_URL、GRIZZLY_TIMEOUT)、当前目录下的 .grizzly.toml、以及 ~/.config/grizzly/config.toml。配置示例为 token_file = "~/.config/grizzly/token"、callback_url = "http://127.0.0.1:42123/success"、timeout = "5s"。
使用要求方面,需要已安装并运行 Bear 应用;部分操作(add-text、tags、open-note --selected)需要 Bear API 令牌。获取令牌的方式是:打开 Bear → Help → API Token → 复制令牌,然后保存到 ~/.config/grizzly/token,例如 echo "YOUR_TOKEN" > ~/.config/grizzly/token。
限制说明:Bear 必须处于运行状态,命令才能生效;笔记 ID 是 Bear 的内部标识符,可在笔记信息中或通过回调查看;需要从 Bear 读取数据时应使用 --enable-callback;部分操作需要有效令牌。