ドキュメント

CLI と MCP stdio

同じコンピュータのエージェントが使う agent-memory コマンドと、MCP stdio の13のツール。

同じコンピュータのエージェントは、agent-memory コマンドか MCP stdio のサーバーで Agent Memory とやり取りします。どちらもネットワークのポートを開きません。

よく使うコマンド

コマンド	すること
`agent-memory health --json`	手元のデータベースを開けるか確かめます。
`agent-memory search --q "<query>" --limit 5`	検索します。
`agent-memory sessions detail --id "<session-id>"`	セッションとそのメッセージを表示します。
`agent-memory hooks status`	各フックとオンかオフかを表示します。
`agent-memory hooks enable <hook>`	フックをオンにします。オフにするときは `disable`。
`agent-memory model prepare`	手元の埋め込みのモデルを取得します。
`agent-memory ingest progress`	取り込みの進み具合とエラーを表示します。
`agent-memory ingest deferred`	失敗が続いて対象から外したファイルを表示します。
`agent-memory cloud login`	クラウドにサインインします。
`agent-memory cloud health`	サインインと API への接続を確かめます。
`agent-memory cloud sources`	`cloud restore` で復元できる元のセッションを一覧します。

Mac でコマンドが PATH にないときは、アプリの中にあるものを使います。

"/Applications/Agent Memory.app/Contents/MacOS/agent-memory" health --json

Mac ではコマンドラインのツールに含まれる agent-memory-mcp がサーバーです。Windows では agent-memory mcp を実行します。どちらも同じ13のツールを持ちます。

クライアントの設定例（macOS）

{
  "mcpServers": {
    "agent-memory": { "command": "agent-memory-mcp" }
  }
}

ツール	すること
`memory_search`	取り込んだセッションのメッセージを探します。ワークスペースで絞り込めます。
`memory_sync`	エージェント向けに、前回からの差分を取り出します。
`memory_get_context`	エージェントの起動時に使う文脈を取り出します。
`memory_get_inbox`	エージェント宛ての未処理のメッセージを取り出します。
`memory_update_state`	エージェントの状態、ワークスペース、作業内容を更新します。
`memory_send_message`	別のエージェントの受信箱にメッセージを送ります。
`memory_log_event`	途中経過などのイベントを記録します。
`memory_create_feedback_event`	エージェントの出力への反応を記録します。
`memory_list_feedback_events`	フィードバックを一覧します。
`memory_create_decision_review`	振り返りを記録し、評価の反転を見つけます。
`memory_list_decision_reviews`	振り返りを一覧します。
`memory_create_preference_pair`	採用した出力と却下した出力の組を記録します。
`memory_list_preference_pairs`	選好ペアを一覧します。