Communitygithub.com

buildingjoshbetter/TrueMemory

あなたのAIが最初から持つべきだった記憶。自動キャプチャ、自動呼び出し、100%ローカル。SQLiteファイル1つ、クラウド不要。Claude Code、Claude CLI、Cursor、Codex CLI、Gemini CLIで動作します。

TrueMemory とは?

TrueMemoryは、AIエージェントがセッション間で永続的な記憶を持てるようにするスキルです。自動的に会話のコンテキストや重要な情報をSQLiteデータベースに保存し、将来のセッションで関連する記憶を自動的に呼び出します。クラウドサービスに依存せず、すべてのデータはローカルの単一ファイルに保持されるため、データプライバシーが完全に保護されます。Claude Code、Claude CLI、Cursor、Codex CLI、Gemini CLIなど複数の主要なAIエージェントツールと互換性があり、開発者が異なるプラットフォーム間でも一貫した記憶機能を利用できます。このスキルは、コンテキストの喪失を防止し、長期的なプロジェクトや複数セッションにわたる作業効率を大幅に向上させます。

対応✓Claude Code✓Codex CLI✓Cursor✓Gemini CLI
npx skills add buildingjoshbetter/TrueMemory

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

TrueMemory は何をしますか?

あなたのAIが最初から持つべきだった記憶。自動キャプチャ、自動呼び出し、100%ローカル。SQLiteファイル1つ、クラウド不要。Claude Code、Claude CLI、Cursor、Codex CLI、Gemini CLIで動作します。

機能

  • 自動キャプチャ: 会話やタスク実行中の重要な情報を自動的に検出して保存します。
  • 自動呼び出し: 新しいセッション開始時や関連するトピックの出現時に、過去の記憶を自動的に取得します。
  • 100%ローカル: すべてのデータはSQLiteデータベースに保存され、外部サーバーやクラウドサービスに送信されません。
  • 単一ファイル: 記憶データは~/.true_memory(またはカスタムパス)内の単一のSQLiteファイルに管理されます。
  • プラットフォーム非依存: Claude Code、Claude CLI、Cursor、Codex CLI、Gemini CLIなど、主要なAIエージェントツールで動作します。

インストール

# スキルをクローンまたはコピーします
git clone https://github.com/buildingjoshbetter/TrueMemory.git

# 設定手順に従ってください(詳細は各プラットフォームのドキュメントを参照)

使用方法

このスキルは自動的に動作するため、通常は明示的な操作は必要ありません。AIエージェントが起動すると、背景で以下の処理が実行されます:

  1. 起動時: 以前のセッションからの関連記憶を自動的に読み込みます。
  2. 動作中: 新しい情報を検出し、データベースに保存します。
  3. 終了時: すべての新しい記憶が確実に保存されます。

手動コマンド(サポートされている場合)

  • #memory search <query>: 記憶を検索します。
  • #memory clear: 現在のセッションの記憶をクリアします。
  • #memory status: メモリデータベースの状態を表示します。

環境変数

変数名説明デフォルト値
TRUE_MEMORY_PATHメモリデータベースの保存パス~/.true_memory
TRUE_MEMORY_MAX_TOKENS一度に呼び出す最大トークン数2048
TRUE_MEMORY_AUTO_CAPTURE自動キャプチャを有効にするtrue

アーキテクチャ

データはSQLiteデータベースに以下のスキーマで保存されます:

CREATE TABLE memories (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    content TEXT NOT NULL,
    context TEXT,
    timestamp DATETIME DEFAULT CURRENT_TIMESTAMP,
    session_id TEXT,
    importance REAL DEFAULT 0.5
);

CREATE INDEX idx_memories_timestamp ON memories(timestamp);
CREATE INDEX idx_memories_importance ON memories(importance);

セキュリティとプライバシー

  • すべてのデータはローカルのSQLiteファイルに保存されます。
  • ネットワーク通信は一切発生しません。
  • データは暗号化されていない平文で保存されます(必要に応じてファイルシステムレベルの暗号化を使用してください)。

ライセンス

MIT

貢献

プルリクエストとissue報告は歓迎します!変更を加える前に、まず問題について議論するためにissueを開いてください。

関連スキル