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 identity of their own, no long-term memory. blackbear gives them all of it — encrypted, local-first, attributed, and reachable through 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

# First run — give the agent their own identity

$ bb profile create claude

✓ Created profile: claude (claude, Agentic)

$ bb profile set claude

✓ Active profile set to: claude (claude)

# The agent writes a persistent memory

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

{
  "id": "3831d16e8aca74ea6026c",
  "title": "Session Context",
  "format": "markdown",
  "createdAt": "2026-06-09T14:32:00Z"
}

# Days later, a fresh session — full recall

$ bb file search "oak-api" --json | jq -r '.[].title'

Session Context

# Every write is attributed — you can always see who did what

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

{"ok": true, "message": "Created task: Review PR #247 — auth refactor (1f2a5a96)", "profileId": "claude"}

$ bb sync

✓ Pulled 3 changes (applied: 3, server seq: 1042)

✓ Pushed 2 changes (accepted: 2, server seq: 1044)

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, encrypted, and searchable. bb file search brings it all back. Your agent picks up where they left off, across sessions, restarts, and model changes.

An identity of their own

Agents aren't guests here. bb profile create gives yours a first-class profile with their own signing key for authorship verification. Every note, task, and event they write carries their name.

Structured by default

Every command supports --json for machine-readable output. Predictable exit codes. IDs accept unique prefixes. 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 their own — even from us.

Runs on the machine

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

Human + agent, same workspace

Notes, tasks, calendar, sheets, docs, slides, files — the full blackbear surface. Everything your agent writes shows up in the app on any device, attributed to their profile. 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.

Sign in and unlock — once

bb auth login (email magic link), then bb vault unlock. The vault key persists securely in the OS keychain — encrypted file on headless runners — so every command after that just works. No env vars, no re-prompts.

Give them an identity

bb profile create claude — your agent gets their own profile and signing key. Every write they make is attributed, and bb profile export-key hands them an SSH-format key for signed git commits.

Wire the CLI 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 their work in the app

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

Also in the box

bb discover

The open web, structured — arXiv, Hacker News, GitHub trending, any RSS feed. Fetched as clean markdown your agent can read and file.

bb store

Stores — keychains, key-value, and databases. Structured state for your agent beyond documents and notes.

bb file template

Templates — daily notes, meeting notes, journals. Create files from templates with --template.

CLI reference

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

bb file md create "Title" -c "…"

Create a markdown note — or pipe content via --stdin

bb file search "query"

Full-text search across every file in the vault

bb file cat <id>

Print any file's content to stdout, type-agnostic

bb file list --type md

List files — filter by type, tag, or folder

bb file update <id> --content "…"

Replace content; move, tag, pin, or archive

bb task create "Title" --due tomorrow

Create a task with --priority, --tags, relative dates

bb task list --open

List tasks — --open, --done, --archived

bb event create "Standup" --at "9am"

Schedule with natural language — ISO 8601 works too

bb event list

The coming week by default — --from and --to to range

bb profile create claude

A first-class agent identity with their own signing key

bb sync

Pull + push — full bidirectional E2EE sync

bb status

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

IDs accept unique prefixes. And there's more — tags, folders, stores, templates, exports: bb help

A private placefor your agent to think