GitHub – timgordontg/engrim: ユニバーサルクロスモデルエピソードメモリ標準。 Google Antigravity、Claude Code、Cursor、Windsurf 用の SQLite インメモリ エンジン。これは最初のローカル プロジェクトです。雲のブロックゼロ。
PyPI
パイソン
ライセンス: MIT
ローカルとプライベート

ユニバーサルクロスモデルおよびクロスエージェントエピソード記憶ストア。

プロジェクトファーストネイティブの SQLite インメモリ エンジンにより、開発者はモデルと環境を自由に切り替えることができます (Google反重力コード・クロードカーソルMCPウィンドサーフィン) で 同じ アーキテクチャ上の決定、ユーザーの制約、プロジェクトのステータスを失うことなくプロジェクトを実行できます。


1. 本当の価値の提供

「なぜ毎ターン忘れ去られたサウンド トークン 200,000 個を支払う必要があるのでしょうか?モデルは使い捨てのサービスですが、プロジェクトの決定は使い捨てではありません。」

コンテキスト ウィンドウが 100 万以上のトークンに拡張されると、開発者は課題に直面します 注意欠陥: 推論は低下し、会話が進むたびにコストが増加し、文脈がクリアになると全身記憶喪失につながります。

engrim 注意力の低下を補う 4,000 文字のソートされたエピソード作業記憶:

  • AI記憶のスイス: プロジェクト インテリジェンスを単一の AI ベンダーまたはプライベート クラウド サイロから分離します。 Cursor プロジェクトの途中で、Antigravity の Gemini 3.8 から Claude Code の Claude 3.7 Sonnet、GPT-4o に切り替えると、エージェントは他のエージェントが中断したところから再開します。
  • 自己暗号化の保存ボタン: 作業中に決定、制約、ステートメントを外部化します。エージェント セッションを自由にクリアしてください (/clear) すぐにコンテキストがリロードされるのを確認します。
  • スマートコンテキストをダウンロードする: 静的ベクトル配置を使用した SQLite FTS5 (bm25 キーワード検索) (model2vec)ゼロ往復ハイブリッド融合エンジンで。

2. 実験的証明 (研究 105 セッション)

50,000 ラインの取引アルゴリズム システムで 105 回の連続セッションでテストされました。 186 個の単体テストで回帰ゼロ、モデル切り替え全体でコンテキスト記憶喪失もゼロ。

実際の資本を使用したアクティブなアルゴリズム取引コードに基づく実稼働テストでは、次のようになります。

  • バー 153,000 件の雇用標識 アーキテクチャの時代には、パラメータ設定とデバッグはその下のアクティブ メモリ パッケージに統合されていました。 1000トークン (コンテキスト ウィンドウの 1% 未満)。
  • それは リロードコンテキストのコストを 99% 以上削減 セッションごとに再起動します。
  • 同様のリポジトリ内の Google Antigravity CLI、Claude Code、Cursor MCP の間で、モデル ドリフトやアーキテクチャ回帰がゼロでシームレスに切り替えられました。

graph TD
    subgraph Agents ["Supported Agent Environments"]
        AGY["Google Antigravity
(PreInvocation & Stop Hooks)"] CLAUDE["Claude Code
(SessionStart & Stop Hooks)"] CURSOR["Cursor / Windsurf
(Model Context Protocol stdio)"] end subgraph CoreEngine ["engrim Core Engine (v1.3.0)"] ADAPTERS["Adapters & Hooks
(agy, claude, mcp)"] PROVENANCE["Agent Provenance Engine
(origin_agent tracking)"] ROUTER["Hybrid Retrieval & Minder
(bm25 lexical + vector cosine)"] end subgraph Storage ["Local-First SQLite Store (~/.engrim/memory.db)"] MEMORIES[("Curated Memories
(decisions, facts, feedback)")] FTS5["FTS5 Full-Text Search
(porter stemmer, triggers)"] VEC["Vector Embeddings
(model2vec static embeddings)"] LOG["Flight Recorder Log
(turns + action lines)"] end AGY <-->|"hook / CLI"| ADAPTERS CLAUDE <-->|"hook / CLI"| ADAPTERS CURSOR <-->|"JSON-RPC (stdio)"| ADAPTERS ADAPTERS --> PROVENANCE PROVENANCE --> ROUTER ROUTER --> MEMORIES MEMORIES --- FTS5 MEMORIES --- VEC ADAPTERS --> LOG



読み込み中



4.多機能クイックスタート

自動検出 (推奨)

ランニング engrim setup 証拠なしで。マシンにインストールされている環境を自動的に検出し、すべての環境を構成します。

  • もし ~/.gemini がある $\右矢印$ シム反重力ライフタイムフック、スキル、MCPサーバー。
  • もし ~/.claude がある $\右矢印$ Claude Code SessionStart、Stop、ステータス行、および CLAUDE.md をワイヤリングします。
  • もし ~/.cursor がある $\右矢印$ Cursor MCP 設定を生成してマージします。
  • 調整します ~/.gemini/config/hooks.json 実行する engrim hook --agent agy --event bootPreInvocation そして engrim hook --agent agy --event stopStop
  • 正規スキル「反重力」を使用する ~/.gemini/config/skills/engrim/SKILL.md
  • MCPサーバーを起動します ~/.gemini/antigravity-cli/mcp_config.json そして ~/.gemini/config/mcp_config.json
  • ワイヤー SessionStartSessionEndStopそして UserPromptSubmit 閉まる ~/.claude/settings.json
  • クロード コード ステータス バーに環境ステータス バーを設定します。
  • メモリ使用量のメモを追加 ~/.claude/CLAUDE.md
  • 追加します engrim~/.cursor/mcp.json 走る engrim serve --mcp

加えて engrim あなたへ ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "engrim": {
      "command": "engrim",
      "args": ["serve", "--mcp"]
    }
  }
}
  • サポートされている各環境を 1 つのコマンドで構成します。

(使用 --dry-run ドライブを変更せずに変更を確認するには、セットアップ コマンドを使用します)。


5. エージェントの出所を追跡する

複数のエージェントが単一のデータベース内で対話する場合、ソースが重要になります。 engrim 各メモリエントリの発生 origin_agent エリア:

  • 許可される値: antigravityclaude-codecursorcliまたは user
  • アクティブなフック、MCP クライアント、または CLI セッションに基づいて自動的に設定されます。
  • 微妙な形で出てきました engrim context そして engrim list:
🧠 engrim · memory restored for this project — you don't have to re-explain · /workspace
  18 of 54 curated records loaded (~3850 chars) · the rest one `recall` away

[DECISION]
- #961 [DECISION] (via Antigravity): Inverted stop loss matrix for high volatility  (risk, execution)
- #942 [DECISION] (via Claude Code): Switched primary database from MongoDB to PostgreSQL  (db, schema)
- #910 [DECISION] (via Cursor): Standardized on Pydantic v2 schemas across API boundaries  (api, types)

最初にアクセスしたときの既存のデータベース ALTER TABLE memories ADD COLUMN origin_agent TEXT


6. 強化されたサーバー モデル コンテキスト プロトコル (MCP)。

依存関係のない JSON-RPC 2.0 stdio MCP サーバーを起動します。

engrim serve --mcp
# or: engrim mcp

stdout JSON-RPC メッセージおよびすべての診断レポート用に厳密に予約されています。 stderr

道具 サイン 目的
engrim_recall (query: str, project: str = "auto", k: int = 5, type: str = None) プロジェクト メモリからのハイブリッド検索 (キーワード + セマンティック)。
engrim_add (type: str, summary: str, detail: str = None, tags: list[str] = []) セッション全体で永続メモリ ログを書き込みます。
engrim_context (project: str = "auto", budget: int = 4000) キャラクターの予算内でセッションローディング メモリ パッケージを入手してください。
engrim_review (project: str = "auto") クリアする前に、記録レポートから保留中の決定を確認してください。


注文 使用法 説明
engrim add engrim add -t decision -s "..." [--origin-agent agy] メモリ ログを入力します (タイプ: decisionfactfeedbackstateuserreference)。
engrim recall engrim recall -q "database" ハイブリッド プロジェクトの評価リコール (--log 生の回転を探します)。
engrim context engrim context [-b 4000] 事前予約済み、予算制限のある、スーパーチャージされたセッション パック。
engrim hook engrim hook --agent agy --event boot Antigravity と Claude Code のエージェント サイクル フック ランナー。
engrim setup engrim setup [--agy|--claude|--cursor|--all] マルチエージェント環境のユニバーサル構成。
engrim serve engrim serve --mcp エージェント統合のために stdio MCP サーバーを起動します。
engrim review engrim review 削除しても安全な範囲チェック: ログをスキャンして即時の解決策を見つけます。
engrim list engrim list [-k 20] 現在のプロジェクトの最近の思い出のリスト。
engrim supersede engrim supersede --id 12 --status superseded 履歴をクリアせずに、変更されたレコードをマークします。
engrim sync engrim sync [DIR] ブックマークをダウンロードして保存します (1 回限りのシード)。


8. 通常どおりワークフローを続行します

  1. 仕事中に写真を撮る: 重要な決定またはアーキテクチャ ルールが行われるたびに実行されます。 engrim add または電話する engrim_add 彼のエージェントを通じて。
  2. 使ってください resume-pointer: セッションを終了またはクリアする前に、タグ付きレコードを追加します resume-pointer 次のタスクについて説明します。最新の指標は以下に掲載されています [▶ RESUME HERE] 次のセッションのブートローダー パッケージの上に置きます。
  3. で確認してください engrim review: 最近の決定がすべて行われたことを確認してください。
  4. 気軽にクリアしてください(/clear: セッションウィンドウがクリアされます。 engrim 次のリクエストまたは呼び出し時に、アクティブなメモリ パケットが自動的に再挿入されます。

  • 100% ローカルかつオフライン: すべてのメモリ ログとログはローカル SQLite ファイルにあります (~/.engrim/memory.db)。テレメトリ、クラウド同期、追跡はありません。
  • モデルストック: 用途 model2vec ローカル静的デプロイメントの場合 (ロード時間は約 30 ミリ秒、GPU は不要、CPU で実行)。純粋な語彙でも構いません (ENGRIM_EMBED=off) 追加の依存性はゼロです。
  • POSIX ファイルのアクセス許可: データベースは所有者のみに限定された権限で作成されます (0600)。
  • Gitのセキュリティ: *.db デフォルトでは gitignor されます。あなたの思い出が誤ってバージョン管理にコミットされることはありません。

MIT © 2026 ティム・ゴードン。



Source link