Y Combinator の CEO、Garry Tan が自分の AI エージェントのために作った「脳（メモリ）」GBrain。Claude Code や Codex に長期記憶を持たせるまでを、ターミナル初心者でも迷わない順番で解説します。
GBrain は、AI エージェントに「あなたが管理できる長期記憶」を与えるオープンソースのツールです。事実を出典つきで保存し、訂正・削除もでき、複数のエージェント間で同じ記憶を共有できます。Garry Tan 自身の環境では 15 万ページ超・2 万人以上の人物情報を扱っている本番システムです。
PGLite という組み込み DB を使うので、サーバーや Docker は不要。
まずはキーワード検索で開始。必要になったら API キーで意味検索を追加。
MCP 経由で Claude Code・Codex・Cursor などから記憶を読み書き。
必要なのは Mac と「ターミナル」アプリだけです。ターミナルは ⌘+Space で Spotlight を開き「ターミナル」と入力すると起動できます。以下のコマンドは、コピーボタンで写してターミナルに貼り付け、Return で実行してください。
gbrain というパッケージはまったく無関係の別物です。npm install -g gbrain や bun add -g gbrain は実行しないでください。必ず GitHub（github:garrytan/gbrain）から入れます。GBrain は JavaScript ランタイム Bun（1.3.11 以上）で動きます。公式インストーラーで入れましょう。
curl -fsSL https://bun.sh/install | bash終わったら、設定を読み込み直してバージョンを確認します（またはターミナルを一度閉じて開き直してもOK）。
source ~/.zshrc
bun --version✓ 1.3.11 以上の数字が表示されれば成功です。古い Bun が入っている場合は bun upgrade で更新できます。
安定版タグ latest-stable を指定して、GitHub から直接インストールします。
bun install -g github:garrytan/gbrain#latest-stableインストールできたか確認：
gbrain --versionecho 'export PATH="$HOME/.bun/bin:$PATH"' >> ~/.zshrc
source ~/.zshrcローカルに記憶用のデータベースを作ります。PGLite を使うので約 2 秒で完了し、サーバーも Docker もいりません。まずは API キーなし（キーレス）で始めるのがおすすめです。
gbrain init --pglite --no-embedding実行すると検索モードとコストの比較表が表示されます。まずはキーレス（キーワード検索）のままで問題ありません。意味検索などは後から API キーを足すだけで有効にできます。
gbrain doctor✓ 緑のチェックが並べば OK。黄色や赤の項目があっても、gbrain doctor が修正用のコマンドを表示してくれるので、それをそのまま実行します。キーレス運用では API キー関連の警告が出ることがありますが、問題ありません。
ひとつ事実を覚えさせて、読み出せるか確認してみましょう。
gbrain remember "テスト用の合言葉は amber-orbit-1234" \
--entity projects/gbrain-setup --provenance "セットアップテスト"
gbrain recall projects/gbrain-setup✓ 保存した文と出典が表示されれば、あなたの Mac に「脳」ができています。
手元の Markdown ノートを取り込みたい場合は、フォルダを明示して取り込めます（例）：
gbrain import ~/notes --no-embed
gbrain search "最近のテーマは？"作ったブレインを、普段使っているコーディングエージェントに MCP サーバーとして登録します。サーバー起動もトークンも不要です。
# Claude Code の場合
claude mcp add gbrain -- gbrain serve --surface verbs
# Codex の場合
codex mcp add gbrain -- gbrain serve --surface verbs--surface verbs を付けると、エージェントに見せる機能を 7 つの記憶操作（recall / remember / entity / synthesize / forget / context_pack / delta）に絞れます。全機能を使いたい場合はフラグを外してください。
エージェントを再起動して「テスト用の合言葉は？」と聞きます。次に新しい会話を始めて同じ質問をし、答えが返ってくれば、会話の文脈ではなくブレインから思い出せている証拠です。
gbrain serve を 2 つ同時に立ち上げないでください。キーを 1 つ足すだけで機能が広がります。gbrain config set で保存すると ~/.gbrain/config.json に記録されます。
| キー | できるようになること |
|---|---|
VOYAGE_API_KEY | 意味検索（埋め込み）＋リランカー。デフォルト構成。 |
OPENAI_API_KEY | 意味検索の代替、自動の事実抽出、チャット系機能 |
ANTHROPIC_API_KEY | 自動の事実抽出、チャット系機能、クエリ拡張による検索改善 |
gbrain config set ANTHROPIC_API_KEY sk-ant-...
gbrain models doctor # 設定したモデルに疎通確認API キーの利用料は Claude や ChatGPT のサブスクとは別にかかる点に注意してください。
gbrain search "質問" # 関連ページをランキング表示（LLM コストなし）
gbrain think "質問" # 出典つきで答えを合成（要 API キー）
gbrain sync --watch # git リポジトリをライブ同期
gbrain autopilot --install # 夜間に自動で情報を充実させる常駐デーモン
gbrain upgrade # アップデートとスキーマ移行コマンドを自分で打つ代わりに、Claude Code や Codex に次の文をそのまま貼り付ければ、エージェントが公式手順を読んで導入から動作確認まで進めてくれます（英語のまま貼るのが確実です）。
Add GBrain memory to this existing agent. Read and follow:
https://raw.githubusercontent.com/garrytan/gbrain/master/INSTALL_FOR_AGENTS.md
Keep my current identity and instructions. Start keyless, preserve unrelated
configuration, and use the memory-only path. Do not create a personal-agent
identity or private repository. Show me the required search-mode choice.
Verify a unique remember/recall/correction/withdrawal round trip using observed
GBrain calls, then tell me how to verify recall in a new conversation.空のフォルダで Claude Code / Codex を開き、下の文を貼り付けると、あなたへのインタビュー → 人格ファイル（SOUL.md など）の作成 → ローカルブレイン → 非公開 GitHub リポジトリの作成までを約 15 分で行います。
Read and follow every step of:
https://raw.githubusercontent.com/garrytan/gbrain/latest-stable/BOOTSTRAP_FOR_AGENTS.md
Goal: set yourself up as my persistent personal agent in this folder, with gbrain
as your memory. Interview me before writing any identity file — never invent
answers. Ask before anything destructive. You are not done until
`gbrain bootstrap verify` exits 0.bun install -g で postinstall エラーが出るまず gbrain doctor で診断し、gbrain apply-migrations --yes を実行します。それでもダメなら、git から直接入れる確実な方法があります：
git clone https://github.com/garrytan/gbrain.git ~/gbrain
cd ~/gbrain && bun install && bun linknpm uninstall -g gbrain
bun remove -g gbrain
bun install -g github:garrytan/gbrain#latest-stablegbrain doctor も npm 版による上書きを検出して修正方法を表示します。
RuntimeError: Aborted()（macOS アップデート後など）不正終了で DB のログが壊れたのが原因です。上から順に試します。
gbrain doctorgbrain pglite-repair --dry-run → gbrain pglite-repair --yesgbrain reinit-pglite多くは API キー未設定か、スキーマが古いことが原因です。gbrain upgrade --force-schema を試してください。