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エージェントが起動すると、背景で以下の処理が実行されます:
- 起動時: 以前のセッションからの関連記憶を自動的に読み込みます。
- 動作中: 新しい情報を検出し、データベースに保存します。
- 終了時: すべての新しい記憶が確実に保存されます。
手動コマンド(サポートされている場合)
#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を開いてください。