akitaonrails/ai-memory：README に基づく導入ガイド

akitaonrails/ai-memory の README はプロジェクトを「Solution for long term memory for agent coding CLIs and to facilitate handoff between different agent vendors」と説明しています。ここではリポジトリで確認できる事実だけを整理します。star 数やバッジは注目度の手掛かりであり、品質の証明ではありません。「README」には次の説明があります。> Long-term memory for AI coding agents. Quit Claude Code mid-task, > start OpenAI Codex in the same directory, continue without > re-explaining the architecture, the failed approaches, or the open > questions.。これは範囲の説明であり、本番検証の結果ではありません。

README の「Key features」にある内容から、用途が合うかを先に判断できます。Opt-in managed workstreams. ai-memory run claude, then ai-memory run。目的が違うなら、人気だけで採用する理由にはなりません。プロジェクト名やコマンドは原文のまま残し、一次資料へ戻って用語を確認できるようにしています。 README には次の確認可能な項目もあります。Zero-friction lifecycle capture. Hooks fire-and-forget bounded,。初回テストの材料にはなりますが、実際の環境での確認を省略する理由にはなりません。

動作の説明は「What it is」など複数の箇所に分かれています。確認できる情報は次の通りです。LLM coding agents lose context when a session ends. ai-memory gives them a shared, persistent wiki compiled from sanitized lifecycle observations. When a session ends, relevant observations become a coherent summary;。書かれていない構成、性能、セキュリティを推測で補いません。導入時はディレクトリ、設定ファイル、release 履歴を確認してください。

初回導入は README の入口から始めます。確認できるコマンドは次の通りです。 # 1. Install the ai-memory CLI wrapper (a small shell script that # runs the binary inside docker with your $HOME mounted). This is # the only thing that needs to live on the host filesystem. mkdir -p ~/.local/bin wrapper_tmp="$(mktemp -d)" trap 'rm -rf "$wrapper_tmp"' EXIT wrapper_base=https://github.com/akitaonrails/ai-memory/releases/latest/download/ai-memory-wrapper curl -fsSL "$wrapper_base" -o "$wrapper_tmp/ai-memory-wrapper" curl -fsSL "$wrapper_base.sha256" -o "$wrapper_tmp/ai-memo 実行可能なコマンドがない場合は手順を作らず、「What it is」で依存関係、待受ポート、初回設定を確認します。

日常運用は公式文書の範囲に限ります。「What it is」にはThe wiki is plain markdown in a git repo - grep-able, openable in Obsidian, backed up with rsync. No vector database to babysit, no writenote ceremony, no manual context-loading. The full design is in docs/ARCHITECTURE.md.とあります。設定、環境変数、権限、データ保存先は明記されたものだけを扱います。未記載の既定値は隔離環境で確認し、戻せる設定を保存してください。 同じ資料にはPer-repository capture exclusions. A nearest-marker [capture]ともあります。