Repolode
timgordontg

timgordontg/engrim

Claude Code、Cursor、Codex CLIなどのAIコーディングエージェント間で、コーディング上の決定事項やプロジェクトの状態を共有する、ローカル優先・プロジェクト単位のSQLiteメモリエンジンです。

スター
304
フォーク
16
未解決の Issue
4
最終コミット
先月

これは何?

engrimは、AIコーディングエージェントにコードベース共通の永続メモリを提供するPythonツールです。長いチャット履歴を再生する代わりに、アーキテクチャ上の決定事項、事実、制約、現在のタスクなどを厳選した記録として、ローカルのSQLiteファイル(~/.engrim/memory.db)に保存します。新しいセッションの開始時には、サイズ上限付きのメモリパックを注入します。

Google Antigravity、Claude Code、Cursor、Windsurf、Codex CLI、GitHub Copilot CLI、OpenCodeと連携します。エージェントが対応している場合はライフサイクルフックを使い、それ以外の場合はMCPサーバー(engrim serve --mcp)を使用します。各記録には書き込んだエージェントがタグ付けされ、呼び出し時にはFTS5の全文検索とmodel2vecによる静的なベクトル埋め込みを組み合わせます。ベクトル埋め込みを無効にして、語句一致のみで検索することもできます。また、データベースの整合性とフックの設定を検証するヘルスチェック(engrim doctor)に加え、バックアップ、マージ、整理のためのCLIコマンドも備えています。

データはすべてローカルマシンに保存され、テレメトリーやクラウド同期はありません。データベースは所有者のみがアクセスできる権限で作成されます。

主な機能

  • 01同じプロジェクトで複数のAIコーディングエージェントが、1つのローカルSQLiteメモリストアを共有できます。
  • 02セッション開始時にサイズ上限付きのメモリパックを注入し、未完了の作業を再開するためのポインターも含めます。
  • 03FTS5の全文検索とmodel2vecのベクトル埋め込みを組み合わせたハイブリッド検索を提供し、語句一致のみのモードも利用できます。
  • 04各メモリエントリーに、記録元のエージェントを記録します。
  • 05データベースの整合性とフックの設定を確認するengrım doctorを提供し、自動修正も選択できます。
  • 06stdio MCPサーバー経由でengrım_*ツールを公開し、バックアップ、マージ、整理のコマンドも備えています。

ユースケース

  • チャットを消去した後も、アーキテクチャ上の決定事項を説明し直すことなく、Claude CodeやCursorでコードベースの作業を続ける。
  • 同じリポジトリで複数のAIコーディングエージェントを切り替えながら、1つの決定ログを共有する。
  • コンテキストをサードパーティのメモリサービスに送れないコードベースで、プロジェクトのメモリをローカルに保つ。
  • エクスポートしたSQLiteストアをマージし、CIの実行をまたいでメモリを引き継ぐ。

クイックスタート

  1. 1

    PyPIからengrimをインストールする

    pip install engrim
  2. 2

    インストール済みのエージェント環境を自動検出して設定する

    engrim setup
  3. 3

    インストールの状態を確認する

    engrim doctor

使う前に知っておきたいこと

  • Python 3.10以降が必要です。
  • メモリはローカルのSQLiteファイル ~/.engrim/memory.db に保存されます。マシン間でのクラウド同期はありません。
  • Codex CLIのフックは、実行前に手動で確認して信頼する必要があります。

収録されている特集

トピック

よくある質問

engrim とは?
Claude Code、Cursor、Codex CLIなどのAIコーディングエージェント間で、コーディング上の決定事項やプロジェクトの状態を共有する、ローカル優先・プロジェクト単位のSQLiteメモリエンジンです。 engrimは、AIコーディングエージェントにコードベース共通の永続メモリを提供するPythonツールです。長いチャット履歴を再生する代わりに、アーキテクチャ上の決定事項、事実、制約、現在のタスクなどを厳選した記録として、ローカルのSQLiteファイル(~/.engrim/memory.db)に保存します。新しいセッションの開始時には、サイズ上限付きのメモリパックを注入します。
engrim は無料で使えますか?ライセンスは?
engrim は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
engrim は今もメンテナンスされていますか?
半年以内に更新あり。engrim の最終コミットは 2026年9月26日 です。
engrim は何に使えますか?
チャットを消去した後も、アーキテクチャ上の決定事項を説明し直すことなく、Claude CodeやCursorでコードベースの作業を続ける。 同じリポジトリで複数のAIコーディングエージェントを切り替えながら、1つの決定ログを共有する。 コンテキストをサードパーティのメモリサービスに送れないコードベースで、プロジェクトのメモリをローカルに保つ。 エクスポートしたSQLiteストアをマージし、CIの実行をまたいでメモリを引き継ぐ。
engrim のインストール方法は?
PyPIからengrimをインストールする: pip install engrim インストール済みのエージェント環境を自動検出して設定する: engrim setup インストールの状態を確認する: engrim doctor
engrim はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/timgordontg/engrim

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト