bear-notes

Bear Notes

在 macOS 上使用 grizzly 建立、讀取及管理 Bear 筆記。

使用需求

• 已安裝並正在執行 Bear 應用程式
• 部分操作（add-text、tags、open-note --selected）需要 Bear API token（儲存於 ~/.config/grizzly/token）

取得 Bear Token

對於需要 Token 的操作（add-text、tags、open-note --selected），你需要取得驗證 Token：

1. 開啟 Bear -> 說明 -> API Token -> 複製 Token
2. 儲存 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 格式輸出（使用 callback 時）
• --token-file PATH - Bear API token 檔案路徑

設定

Grizzly 讀取設定檔的優先順序如下：

1. CLI 旗標
2. 環境變數（GRIZZLY_TOKEN_FILE、GRIZZLY_CALLBACK_URL、GRIZZLY_TIMEOUT）
3. 當前目錄下的 .grizzly.toml
4. ~/.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 內部識別碼（可於筆記資訊中查看或透過 callback 取得）
• 需要從 Bear 讀回資料時，請加上 --enable-callback
• 部分操作需要有效的 Token（add-text、tags、open-note --selected）