Bear → Canvas → BlueBubbles Sync

Detect #share-tagged Bear notes, update a JSON Canvas knowledge map, and push a preview to a work group via BlueBubbles.

Prerequisites

• Bear app running with grizzly CLI installed
• Bear API token at ~/.config/grizzly/token
• BlueBubbles channel configured in gateway (for iMessage distribution)
• jq available

Workflow

1. Detect — Run scripts/sync_share_notes.sh to query Bear for #share notes via grizzly open-tag --name share.
2. Dedup — The script tracks processed note IDs in ~/.local/share/bear-share-sync/state.json; only new notes are handled.
3. Canvas update — Each new note becomes a green text node appended to canvases/agent_capabilities.canvas. See canvas-schema.md for node structure.
4. Preview — The script outputs a preview summary. If BB_TARGET is set, it signals that a BlueBubbles send is needed.
5. Distribute — When the script signals BB_SEND_REQUIRED=1, use the message tool with channel="bluebubbles" and target=$BB_TARGET to send the preview text.

Running

# One-shot sync
BB_TARGET="+15551234567" bash scripts/sync_share_notes.sh

# Then send preview (if script output includes BB_SEND_REQUIRED=1)
# Use the message tool: action=send, channel=bluebubbles, target=<target>, message=<preview>

Scheduled sync (cron)

Set up a cron job to check periodically:

{
  "schedule": { "kind": "every", "everyMs": 300000 },
  "payload": {
    "kind": "agentTurn",
    "message": "Run bear-share-sync: execute scripts/sync_share_notes.sh with BB_TARGET set to the work group, then send any preview via BlueBubbles if needed."
  }
}

Configuration