The better-bear server provides comprehensive management of Bear notes via CloudKit, enabling full note management, organization, and an LLM-optimized context library.

Note Management

• List, retrieve, create, edit (append, replace body, insert after a line, replace sections, edit front matter), trash, and archive/unarchive notes

Search & Discovery

• Full-text search across titles, tags, and body content with relevance ranking and snippets

• Filter by date range; find untagged notes or duplicates by title

Tag Management

• List all tags with counts and hierarchy; add, remove, rename, or delete tags across notes

TODO Management

• List notes with incomplete TODOs, get all TODO items from a note, and toggle completion status

Attachments

• Attach files or images to notes with control over placement (append, prepend, before/after specific text)

Stats, Health & Sync

• Library statistics (total notes, words, tags, TODOs, top tags)

• Health checks (duplicates, empty notes, sync conflicts, oversized notes)

• Trigger incremental or full iCloud sync

Context Library (LLM Knowledge Base)

• Initialize a curated local folder (bear/, external/, inbox/) optimized for LLM consumption

• Sync qualifying notes (tagged #context) into the library; read the index and fetch specific files

• Search across all context library content (Bear notes, external files, inbox)

• Add/remove notes via tagging; import external content (Jira tickets, Slack threads, docs)

• Triage inbox files: keep (move to external), push to Bear as a note, or discard

• Push external files into Bear as new tagged notes; remove external files

• Monitor context library health: note counts, token totals, sync freshness, warnings

Enables authentication and synchronization with iCloud CloudKit to access and manage Bear notes stored in the cloud.