Bear Notes 是一个面向 macOS 的 Bear 笔记管理技能,通过 grizzly 命令行工具对 Bear 中的笔记进行创建、读取和管理。
用途 该技能用于在 macOS 上以命令行方式操作 Bear 笔记,适合需要自动化或脚本化处理 Bear 笔记的场景。
主要能力
- 创建笔记:可通过管道传入内容,并指定标题与标签。
- 按 ID 打开/读取笔记:使用 open-note 命令,配合 --enable-callback 与 --json 获取返回数据。
- 向笔记追加文本:使用 add-text 命令,指定 --mode append。
- 列出所有标签:使用 tags 命令。
- 搜索笔记:通过 open-tag 按标签名打开,从而检索相关笔记。
使用方式 前置要求:Bear 应用已安装并正在运行。部分操作(add-text、tags、open-note --selected)需要 Bear 应用 Token,Token 存放于 ~/.config/grizzly/token。
获取 Bear Token:打开 Bear → Help → API Token → Copy 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"
适用场景 适用于在 macOS 上通过命令行自动化管理 Bear 笔记,例如批量创建笔记、按标签检索、向已有笔记追加内容等。
限制
- Bear 必须正在运行,命令才能生效。
- 笔记 ID 是 Bear 的内部标识符(可在笔记信息中或通过回调查看)。
- 需要从 Bear 读取数据时,应使用 --enable-callback。
- 部分操作需要有效 Token(add-text、tags、open-note --selected)。
- 该技能面向 macOS 平台。