把 AgentMemory 像卡扣一樣接進 AI 工作流

Codex CLI / Codex Desktop

若你使用 Codex plugin platform，先裝 plugin，再在 Desktop 目前的 workaround 下補上 global hooks。

# Terminal 1: 先讓 memory server 跑著
agentmemory

# Terminal 2: 安裝 Codex plugin
codex plugin marketplace add rohitg00/agentmemory
codex plugin add agentmemory@agentmemory

# Codex Desktop 目前建議補這個 hooks workaround
agentmemory connect codex --with-hooks

Codex plugin 會提供 MCP、6 個 lifecycle hooks，以及 AgentMemory skills。若只需要 MCP，也可用 codex mcp add agentmemory -- npx -y @agentmemory/mcp。

Claude Code

推薦用 Claude Code plugin 安裝，因為它會一次註冊 hooks、skills 與 MCP。

# Terminal 1
agentmemory

# Claude Code session 內
/plugin marketplace add rohitg00/agentmemory
/plugin install agentmemory

# 若不用 plugin，而是直接寫 MCP config，補 hooks:
agentmemory connect claude-code --with-hooks

Cursor、Cline、Windsurf、Gemini CLI 等 MCP host

這類 host 通常只需要把同一個 MCP block 合併進設定檔。不要覆蓋原本整個 config。

{
  "mcpServers": {
    "agentmemory": {
      "command": "npx",
      "args": ["-y", "@agentmemory/mcp"],
      "env": {
        "AGENTMEMORY_URL": "http://localhost:3111"
      }
    }
  }
}

若 host 在 sandbox 內連不到你的 host localhost，設定 AGENTMEMORY_FORCE_PROXY=1 並把 AGENTMEMORY_URL 指到可連的 LAN 或 remote URL。

OpenCode、Hermes、OpenClaw、pi

這些 host 有更深的 plugin 或 memory provider 接法。先用 MCP 跑起來，再依需求安裝對應 integration。

# OpenCode MCP-only
agentmemory connect opencode

# Hermes MCP-only
agentmemory connect hermes

# OpenClaw MCP-only
agentmemory connect openclaw

更完整的 OpenCode hooks、Hermes memory provider、OpenClaw memory slot 可看 repo 內 plugin/opencode/ 與 integrations/。

1. Server health

curl -fsS http://localhost:3111/agentmemory/livez
curl -fsS http://localhost:3111/agentmemory/health

有設定 AGENTMEMORY_SECRET 時，請加上 Authorization: Bearer $AGENTMEMORY_SECRET。

2. REST save/recall round trip

curl -X POST http://localhost:3111/agentmemory/remember \
  -H "Content-Type: application/json" \
  -d '{"content":"AgentMemory workflow snap-in verification","concepts":["workflow","snap-in"]}'

curl -X POST http://localhost:3111/agentmemory/smart-search \
  -H "Content-Type: application/json" \
  -d '{"query":"workflow snap-in verification","limit":5}'

3. MCP tool round trip

在已接入的 agent 中要求它呼叫:

memory_save {
  "content": "AgentMemory MCP wiring works in this agent",
  "concepts": "mcp,wiring,verification"
}

memory_smart_search {
  "query": "MCP wiring works",
  "limit": 5
}

4. Viewer

預設 Viewer:

open http://localhost:3113

如果你用 --port 3112 或目前本機頁面已在 3114，則打開:

open http://localhost:3114/#dashboard

最小安全設定

如果只在本機 loopback 使用，不設 secret 也能跑。若要暴露到 LAN、reverse proxy 或雲端，請設定 bearer token。

# ~/.agentmemory/.env
AGENTMEMORY_SECRET=replace-with-your-own-secret

遠端或 sandbox MCP

當 agent 的 MCP process 不在同一個 localhost namespace，明確指定 URL。

AGENTMEMORY_URL=http://localhost:3111
AGENTMEMORY_FORCE_PROXY=1
AGENTMEMORY_PROBE_TIMEOUT_MS=3000

工具面縮小

有些 host 工具列表太長會干擾模型，可切到 core。一般情況維持預設 full server tools。

AGENTMEMORY_TOOLS=core

多 agent 分工

同一個 server 給 architect、developer、reviewer 共用時，用 AGENT_ID 標記來源。

TEAM_ID=company
USER_ID=engineering
AGENT_ID=architect
AGENTMEMORY_AGENT_SCOPE=shared