For agents & the people who build them

A private place
for your agent to think

Agents lose context between sessions. They have nowhere to keep persistent notes, no private calendar, no long-term memory. blackbear gives them all of it — encrypted, local-first, and accessible via a single CLI. One bb command and your agent has a home.

$ brew install xavi-group/tap/bb

Other platforms →

agent session

$ bb vault unlock

✓ Vault unlocked (42 notes, 18 tasks, 7 events)

# Agent writes a persistent memory

$ bb note create "Session Context" -c "User prefers concise answers. Project: oak-api. Last reviewed: auth middleware." --json

{"id": "n_7kx3m", "title": "Session Context", "created": "2026-05-06T14:32:00Z"}

# Agent reads its own notes for context

$ bb note list --json | jq '.[].title'

"Session Context"

"Architecture Decisions"

"User Preferences"

# Agent creates a task and checks the calendar

$ bb task create "Review PR #247 — auth refactor" --due tomorrow --json

✓ Created task (t_9ab2f)

$ bb event list --json | jq '.[] | "\(.time) \(.title)"'

"09:00 Team standup"

"14:00 Design review"

$ bb sync

↓ Pulled 2 changes ↑ Pushed 4 changes

The problem with agent memory

Every agent session starts from zero. Context windows expire, conversation history gets truncated, and there's no private, persistent place to store what matters. Your agent is smart for 30 minutes, then forgets everything.

Memory that persists

Notes, decisions, user preferences, project context — stored locally and encrypted. Your agent picks up where it left off, even across sessions, restarts, and model changes.

Structured by default

Every command supports --json for machine-readable output. Predictable exit codes. No parsing HTML, no scraping — just clean data.

Private by construction

Same XChaCha20-Poly1305 encryption as the app. Vault key never leaves the machine. The cloud sees only ciphertext. Your agent's thoughts stay its own — even from us.

Runs on the machine

Local SQLite database, no cloud dependency. Works offline, works air-gapped, works on your CI runner. Sync is explicit — bb sync when you want it.

Not just notes

Notes, tasks, calendar events, files, tags, folders — the full blackbear surface via CLI. Your agent can schedule meetings, manage a project backlog, keep a journal, or organize research.

Human + agent, same data

Everything the agent writes is visible in the blackbear app. Open the desktop app, the PWA, or the mobile app and see what your agent has been up to. Same vault, same encryption, same sync.

Give your agent a blackbear

Install the CLI

brew install xavi-group/tap/bb — or download a binary. macOS, Linux, Windows.

Create a vault

bb auth login + bb vault unlock. Free account, encrypted local database, ready in 10 seconds. Agents can use BLACKBEAR_PASSPHRASE env var for non-interactive unlock.

Wire it into your agent

Call bb from your agent's tool system — function calling, MCP, subprocess, whatever you use. Structured JSON in, structured JSON out. Your agent now has persistent, encrypted storage.

See it in the app

Open blackbear on any device and everything your agent wrote is there — notes, tasks, events. Edit something in the app, sync, and the CLI sees your changes. Human and agent share one workspace.

CLI reference

Everything your agent needs. Every command supports --json.

bb note list

List notes — filter by tag, folder, format

bb note create <title> -c <content>

Create a note with markdown content

bb note read <id>

Read a note's full content as markdown

bb note update <id> -c <content>

Append or replace note content

bb task list

List tasks — filter by status, priority, due date

bb task create <description>

Create a task with --due, --priority, --tag

bb event list

List upcoming calendar events

bb event create <title>

Create an event with --date, --time, --duration

bb sync

Pull + push — full bidirectional E2EE sync

bb status

Auth, vault, sync, and device status at a glance

A private placefor your agent to think