Bilinc

Bilinc

AI エージェント向けのホステッドメモリです。 エージェントが学んだことを保存し、行動する前に呼び出し、各メモリを書き込んだ人や変更内容を確認できます。実行に問題があった場合は、ロールバックできます。

PyPI の bilinc パッケージには、Python SDK、bilinc CLI、Bilinc Cloud 用の stdio MCP アダプターが含まれています。ソースコードは ReARCLabs/bilinc にあり、ホステッドサービスはパッケージに含まれていません。

60 秒で始める

Python を使わずに Claude、ChatGPT、Codex を利用する場合。 Claude で Customize → Connectors → Add custom connector を開き、Bilinc と名前を付けて https://mcp.bilinc.space/mcp を貼り付けます。サインインして、読み取り専用または読み取りと書き込みを選択します。Claude Code の場合：

claude mcp add --transport http --scope user bilinc https://mcp.bilinc.space/mcp

ChatGPT と Codex でも同じアドレスを使用できます：リモート MCP ガイド。

Python、CLI、または任意の MCP クライアントを使う場合。

pip install -U bilinc
bilinc login        # browser sign-in, free, no card required
bilinc quicktest    # one hosted commit, one recall and a status check

bilinc login は、このコンピューター用の API キーを所有者のみがアクセスできる権限で保存します。このキーが URL やターミナルに表示されることはありません。ブラウザーを使わない場合は、bilinc login --device を使用してください。CI やスクリプトでは、BILINC_API_KEY を設定します。

Bilinc の位置づけ

すべての書き込みでは、その情報の出所が記録され、返されたバージョンを渡すことで、読み取ってからメモリに変更があった場合に更新を拒否できます。削除には理由が必要で、修正時にも理由を付けられます。リモートコネクターでは、呼び出したメモリごとに最終確認日時が表示され、確認期限を過ぎた項目には古くなっている可能性があることが示されます。この確認によって、情報が非表示になったり削除されたりすることはありません。

類似していても、最新とは限りません

次のような場合は Bilinc をお使いください。

• 長期間稼働するエージェント（コーディング、サポート、調査、パーソナルアシスタント）が、リスクのある操作を行う前に過去の決定を確認する必要がある場合。
• エージェントの状態の一部を書き込んだ実行、ツール、または人を把握する必要がある場合。
• 誤った状態を書き込んだ実行があり、手作業でのクリーンアップではなく、元に戻す手段が必要な場合。
• 複数のエージェントやチームメンバーが 1 つのメモリを共有し、キーごとのアクセス制御と利用状況の可視化が必要な場合。

ドキュメントのセマンティック検索だけが必要な場合は、別の方法をお選びください（ベクトルデータベースのほうがシンプルなツールです）。Apache-2.0 の完全なセルフホスト可能なランタイムが必要な場合も同様です（このパッケージはクラウド専用で、ライセンスは BUSL-1.1 です）。また、メモリレイヤーをエージェントフレームワークとしても使いたい場合にも、別のものをお選びください。

Python SDK

from bilinc import CloudClient

client = CloudClient()  # reads BILINC_API_KEY or the key saved by `bilinc login`

# Write, and keep the version for optimistic concurrency.
written = client.commit("agent.goal", {"ship": "reliable memory"}, memory_type="semantic")
results = client.recall("agent goal", limit=5)

# Correct something you already know. Fails if the key does not exist.
client.revise("agent.goal", {"ship": "verifiable memory"},
              reason="scope corrected", expected_version=written["entryVersion"])

# Checkpoint before risky work, then see what changed.
snapshot = client.create_snapshot(label="before-autonomous-run")["snapshot"]
client.diff(snapshot["id"])

# Recover. The preview is free; executing needs its token.
preview = client.rollback_preview(snapshot["id"], reason="undo bad agent run")
client.rollback(snapshot["id"], confirmation_token=preview["confirmationToken"],
                reason="undo bad agent run")

# Review what is stored. Listing, history and export are free reads.
for entry in client.iter_memories(prefix="agent."):
    print(entry["key"], entry["updatedAt"])
client.history("agent.goal")
client.confirm("agent.goal")   # still accurate; costs one write

# Take a memory out of use. A reason is required and recorded.
client.forget("agent.goal", reason="superseded by the planner service")

CLI

bilinc status                          # plan, capabilities, limits, usage
bilinc commit --key agent.goal --value '{"ship":"reliable memory"}'
bilinc recall --query "agent goal"
bilinc revise --key agent.goal --value '{"ship":"verifiable memory"}' --reason "scope corrected"
bilinc list --prefix agent.            # keys, types, update times, value previews
bilinc history agent.goal              # recorded changes, newest first
bilinc snapshot create --label before-autonomous-run
bilinc diff --from-snapshot snap_...
bilinc export -o bilinc-export.json    # full values; the file is readable only by you
bilinc forget --key agent.goal --reason "superseded by the planner service"

ロールバックは2段階で、実行時に確認を求めないため、自動化でも安全に使用できます。

bilinc rollback preview --snapshot snap_... --reason "undo bad agent run"
bilinc rollback execute --snapshot snap_... --reason "undo bad agent run" \
  --confirmation-token <token-from-preview>

MCP アダプター

stdio アダプターは、Claude Code、Codex、Cursor、Hermes Agent、opencode など、あらゆる MCP クライアントで動作します。bilinc login の後、CLI にセットアップを書き込ませます。

bilinc mcp install --client claude-code     # prints a ready `claude mcp add ...` command
bilinc mcp install --client claude-desktop  # prints the config and where Claude Desktop keeps it
bilinc mcp install                          # plain mcpServers JSON for any other client

設定にキーは含まれません。アダプターは bilinc login で保存したキーを読み込みます。キーが保存されていないマシンでは、"env": { "BILINC_API_KEY": "..." } を追加してください。

ツール	内容
commit_mem	出典とともに永続的な状態を保存します。バージョンを返します。
recall	行動する前に、以前のコンテキストや決定を探します。
revise	既存のメモリを修正します。新規作成はしません。
forget	メモリを使用対象から外します。破壊的な操作です。理由が必要です。
status	ワークスペース、プラン、機能、制限、使用状況を表示します。課金されません。
snapshot	リスクの高い作業の前にチェックポイントを保存するか、チェックポイントの一覧を表示します。
diff	チェックポイントを別のチェックポイント、または現在の状態と比較します。
rollback	チェックポイントを復元します。無料のプレビュー後、確認を経て実行します。
list_memories	保存されている内容を確認します。無料です。
history	1つのメモリの変更履歴を、新しい順に表示します。無料です。
confirm	メモリが現在も正確であることを記録します。書き込みは1回です。

https://mcp.bilinc.space/mcp のリモートコネクターには10個のツールがあります。読み取り専用接続では、4つの読み取りツールのみが表示されます。クライアントガイド：Claude Code · Codex · Cursor · あらゆる MCP クライアント。

Forget と purge

2.5.0 以降：client.forget(key, reason=..., purge=True)、bilinc forget --key ... --reason ... --purge、または REST API の "purge": true を指定すると、メモリの保存内容もストレージと履歴から削除されます。以前に忘却したメモリにも適用でき、取り消すことはできません。保持される情報と期間については、プライバシーポリシーをご覧ください。

ホステッド API

すべてのエンドポイントは https://bilinc.space 配下にあります。メモリ操作には API キーと有効な Bilinc Cloud プランが必要です。無料プランではカードは不要です。

エンドポイント	説明
GET /api/cloud/health	公開サービスの稼働状況です。キーは不要で、課金されません。
GET /api/cloud/status	1つのキーで実行できる操作を表示します。課金されません。
POST /api/cloud/memory/commit · recall · revise	書き込み、読み取り、修正を行います。
POST /api/cloud/memory/forget	破壊的な操作です。理由が必要です。"purge": true を指定すると、保存内容も削除されます。
GET · POST /api/cloud/memory/snapshots	チェックポイントの一覧表示（無料）または作成を行います。
POST /api/cloud/memory/diff	チェックポイントを比較します。無料です。
POST /api/cloud/memory/rollback/preview	無料です。確認トークンを返します。
POST /api/cloud/memory/rollback	破壊的な操作です。トークンが必要です。

再試行する可能性のある書き込みには、Idempotency-Key ヘッダーを指定してください。同じペイロードで同じキーを使うと、元の結果が再生され、課金は1回のみです。異なるペイロードを指定すると、409 idempotency_conflict で拒否されます。API キー、トークン、秘密鍵などの認証情報を含む保存は secret_detected で拒否され、値が返されることはありません。

2.6.0 の新機能

• リストの並べ替え：SDK、CLI、bilinc MCP アダプター、ダッシュボードから、メモリーを新しい順または古い順に並べ替え、保存したアプリで絞り込めます。
• トルコ語の検索：ホスト型検索では、大文字と小文字、トルコ語のドット付きおよびドットなしの I、発音区別符号が区別されないため、girisimci で Girişimci が見つかります。
• 書き込み結果の明確化：認証情報と思われるフィールドがマスキングされて保存された場合、レスポンスにそのフィールド名が示されます。
• MCP アダプターからの完全削除：bilinc の stdio MCP アダプターの forget ツールで purge を指定できるようになりました。

すべてのリリース：変更履歴。

リンク

• bilinc.space · ドキュメント · インストールガイド · 料金（無料プラン、カード不要） · 変更履歴 · 信頼性
• 比較：ベクトルメモリー · Mem0 · Zep · Letta
• ガイド：AI エージェントのメモリーとは？ · エージェントのメモリーへの書き込みをロールバックする · エージェントが記憶した内容を監査する
• マシン向け：llms.txt · ai-index.json

フィードバックとセキュリティ

質問、バグ、アイデア：GitHub Issues。セキュリティ上の問題は、[email protected] まで非公開で報告してください（security.txt を参照）。メモリーの値、API キー、本番環境のログを、Issue やスクリーンショットに含めないでください。

ライセンス

ReARC Labs Inc. がライセンスを付与する Business Source License 1.1 です。LICENSE を参照してください。