用途:在 macOS 上通过 grizzly 命令行工具创建、读取和管理 Bear 应用中的笔记。
前提条件:需已安装并运行 Bear 应用;部分操作(add-text、tags、open-note --selected)需要 Bear 应用令牌,存放于 ~/.config/grizzly/token。
获取令牌:打开 Bear → Help → API 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。 按标签搜索:grizzly open-tag --name "work" --enable-callback --json。
常用选项:--dry-run 预览 URL 而不执行;--print-url 显示 x-callback-url;--enable-callback 等待 Bear 响应(读取数据时必需);--json 以 JSON 输出(配合回调时使用);--token-file PATH 指定令牌文件路径。
配置优先级:CLI 参数 > 环境变量(GRIZZLY_TOKEN_FILE、GRIZZLY_CALLBACK_URL、GRIZZLY_TIMEOUT)> 当前目录 .grizzly.toml > ~/.config/grizzly/config.toml。示例配置含 token_file、callback_url、timeout 字段。
限制:Bear 必须处于运行状态命令才有效;笔记 ID 为 Bear 内部标识符;读取数据需加 --enable-callback;部分操作需有效令牌。