エージェントと、それを作る人のために
エージェントはセッションが変わるたびに文脈を失います。メモを残しておく場所も、自分だけのIDも、長期的な記憶もありません。blackbearはそのすべてを与えます。暗号化され、ローカルファーストで、誰が書いたかがわかり、bbコマンドラインからも、エージェントがすでに使い方を知っているMCPサーバーとしても使えます。一度インストールすれば、エージェントに居場所ができます。
{
"id": "3831d16e8aca74ea6026c",
"title": "Session Context",
"format": "markdown",
"createdAt": "2026-06-09T14:32:00Z"
} エージェントのセッションは、毎回ゼロから始まります。コンテキストウィンドウは尽き、会話履歴は切り詰められ、大切なことをしまっておくプライベートで永続的な場所もありません。エージェントが賢いのは30分間だけで、そのあとはすべて忘れてしまいます。
メモ、決定事項、ユーザーの好み、プロジェクトの文脈を、ローカルに暗号化して保存し、検索できます。bb file searchですべてを呼び戻せます。セッション、再起動、モデルの変更をまたいでも、エージェントは前回の続きから始められます。
エージェントはここではお客様ではありません。bb profile createで、作成者を検証するための署名鍵を持つ正式なプロフィールが作られます。エージェントが書くノート、タスク、予定にはすべてその名前が付きます。
すべてのコマンドが、機械で読める出力のための--jsonに対応。終了コードは予測可能で、IDは一意な接頭辞でも指定できます。HTMLの解析もスクレイピングも不要で、きれいなデータだけが返ります。
アプリと同じXChaCha20-Poly1305暗号化。保管庫の鍵はマシンの外に出ません。クラウドに届くのは暗号文だけです。エージェントの考えは、私たちからさえも守られます。
保存時に暗号化されるローカルのSQLiteデータベースで、クラウドに依存しません。オフラインでも、エアギャップ環境でも、CIランナーでも動きます。同期は明示的で、必要なときにbb syncを実行します。
ノート、タスク、カレンダー、シート、ドキュメント、スライド、ファイルなど、blackbearのすべて。エージェントが書いたものは、どのデバイスのアプリにも、そのプロフィールの名前で表示されます。同じ保管庫、同じ暗号化、同じ同期です。
brew install xavi-group/tap/bb、またはバイナリをダウンロード。macOS、Linux、Windowsに対応。
bb auth loginでブラウザが開き、このマシンのAPIキーに与えるスコープを選びます。次にbb vault unlock。保管庫の鍵はOSのキーチェーン（ヘッドレスのランナーでは暗号化ファイル）に安全に保存されるので、以降のコマンドはそのまま動きます。環境変数も、再入力も不要です。
bb profile create claudeで、エージェントに専用のプロフィールと署名鍵ができます。すべての書き込みに作成者が記録され、bb profile export-keyで署名付きgitコミット用のSSH形式の鍵を渡せます。
MCPサーバーは1行で追加できます：claude mcp add blackbear -- bb mcp（またはcodex mcp add、あるいは任意のMCPクライアント）。関数呼び出しやサブプロセスなど、どんなツールの仕組みからでも、構造化されたJSONでbbを呼び出せます。MCPについて詳しく
どのデバイスでblackbearを開いても、エージェントが書いたノート、タスク、予定がそれぞれプロフィールの名前付きでそろっています。アプリで編集して同期すれば、CLIにも反映されます。人とエージェントがひとつのワークスペースを共有します。
MCPサーバー
bb mcpは、Pax自身のツールをあなたのマシンからMCPで提供します。エージェントは、Paxがアプリで使うのと同じツールとエンジンで、ノート、ドキュメント、シート、スライド、キャンバス、ページ、タスク、カレンダーを検索し、読み、（許可すれば）変更できます。ホスティングされるものは何もありません。
ファイル、タスク、予定をまとめて検索し、IDを指定して開く、アウトラインを見る、編集する。対象はMarkdownのノート、ドキュメント、シート、スライド、キャンバス、ページ、そしてタスクと予定です。結果は読みやすく構造化されて返り、失敗した呼び出しは固定のコードとヒントで理由を伝えます。
bb mcpだけなら読み取りのみです。--writesを付けると作成、編集、ゴミ箱への移動ができ、削除したものはゴミ箱に入って復元できます。Paxに対して読み取り専用にしたものはそのままで、アプリで承認が必要な操作はここでは拒否されます。
サーバーはあなたのマシン上でstdio経由で動き、すでにそこにある暗号化されたワークスペースのコピーを扱います。起動時と変更の少しあとに同期し、--no-syncを付ければ完全にオフラインのままです。
または、Blackbearプラグインをインストールしましょう。同じサーバーを設定し、まず探してからIDで操作するようエージェントに教える短いスキルを追加します。Claude Codeでは/plugin marketplace add xavi-group/blackbear-pluginsのあとに/plugin install blackbear@blackbear。Codexではcodex plugin marketplace add xavi-group/blackbear-pluginsのあと、/pluginsからインストールします。GitHubで見る Pax自身の会話はアプリの中にとどまり、公開されることはありません。
APIキー
マシンやエージェントごとに、選んだスコープだけを持つアカウントAPIキーを発行します。bb auth loginでブラウザが開き、そこで一覧を確認します。各キーはほかに影響を与えず個別に取り消せます。
sync 同期されたワークスペースの読み書きと保管庫のロック解除。マシンをデバイスとして追加する唯一のスコープです。
account:read アカウント、デバイス、キーを閲覧。何も変更しません。
media 添付ファイルのアップロードとダウンロード。
messaging エンドツーエンド暗号化されたメッセージの送受信。
collab リアルタイムの共同編集への参加。
inference 「AI models」として表示 Blackbearが管理するモデル、画像生成、Web検索。クレジットを消費するため、最初から選択されることはありません。
「Settings › Account › API keys」に、すべてのキーがスコープとともに一覧表示されます。そこで発行することも（保管庫で確認され、キーは一度だけ表示されます）、使わなくなったキーをすぐに取り消すこともできます。
bb auth login --api-keyは、発行したキーを$BLACKBEAR_API_KEY、パイプ入力、または非表示のプロンプトから読み取ってサインインするので、シェルの履歴に残りません。--no-browserを付けると、サインイン用のリンクを開かずに表示します。
Web Clipperには専用の種類のキーがあります。できるのは、あなたのデバイスのひとつに封をしたクリップを届けることだけで、ほかのキーにはそれができません。
bb discover 構造化されたオープンなWeb。arXiv、Hacker News、GitHubのトレンド、あらゆるRSSフィード。エージェントが読んで整理できるきれいなMarkdownとして取得します。
bb store ストア：キーチェーン、キーバリュー、データベース。ドキュメントやノートを超えた、エージェントのための構造化された状態。
bb file template テンプレート：デイリーノート、会議メモ、ジャーナル。--templateでテンプレートからファイルを作成できます。
エージェントに必要なものはすべて。どのコマンドも--jsonに対応しています。
bb file md create "Title" -c "…" Markdownのノートを作成。--stdinで内容をパイプ入力も可能
bb file search "query" 保管庫内のすべてのファイルを全文検索
bb file cat <id> 種類を問わず、ファイルの内容を標準出力に表示
bb file list --type md ファイルを一覧表示。種類、タグ、フォルダで絞り込み
bb file update <id> --content "…" 内容の置き換え、移動、タグ付け、ピン留め、アーカイブ
bb task create "Title" --due tomorrow --priority、--tags、相対的な日付でタスクを作成
bb task list --open タスクを一覧表示：--open、--done、--archived
bb event create "Standup" --at "9am" 普段の言葉で予定を登録。ISO 8601も使用可能
bb event list デフォルトは次の1週間。--fromと--toで範囲を指定
bb profile create claude 専用の署名鍵を持つ、エージェントの正式なID
bb sync プルとプッシュ。双方向のE2EE同期
bb status 認証、保管庫、同期、プロフィール、デバイスの状態を一目で
bb mcp PaxのツールをローカルのMCPサーバーとして提供。読み取り専用
bb mcp --writes 作成、編集、移動、ゴミ箱への移動も可能に
bb auth login --scopes sync,account:read ブラウザでのサインインで提示するスコープを事前に選択
bb auth login --api-key Settingsで発行したキーでヘッドレスにサインイン
IDは一意な接頭辞でも指定できます。ほかにも、タグ、フォルダ、ストア、テンプレート、書き出しなどがあります：bb help