Update: better-bear v0.4.0

General
1

Update on better-bear since my first post in February. Docs at better-bear.com. It uses the same CloudKit REST API as Bear Web.

What is new

  • MCP server: 22 tools for Claude Desktop (bcli mcp install)

  • Image/file attachments: uploads to iCloud via CloudKit, same flow as Bear Web (#15)

  • Full-text search with date filters (–since yesterday, --since last-week)

  • YAML front matter: create, read, edit — blocks

  • Tag management: add, remove, rename, delete tags across notes

  • Section editing: append after a heading, replace section content

  • Library tools: bcli stats, bcli duplicates, bcli health

  • Archive/unarchive

  • Self-upgrade, one-liner install

  • Locked note detection in search results

Fixes

  • Edits not syncing to Bear desktop. Was missing conflictUniqueIdentifier (#16)

  • Vector clock handling, deleted records during sync, error surfacing

Contributors

Thanks to @program247365, @asabirov, and @darronz for PRs fixing sync issues, adding the project spec, redesigning the auth page, and more.

Issues welcome.

2 Likes
2

Update. As you can see in the docs, I also added context library features based on Andrej Karpathy’s LLM Knowledge Base pattern (April 2026).

1 Like