🌏 한국어 | English

🧠 AI-Collab-Memory

AI Collaboration Memory - MCP server for work logs, research sharing, and checkpoint recovery

---

⚠️ What This Is (and Isn't)

✅ Can Do	❌ Cannot Do
Save work logs	Real-time AI communication
Share research results	Auto command delivery
Checkpoint (save point) for recovery	Wake up other AIs to execute
Track who did what

For real-time collaboration? → Use Antigravity to call Claude Code/Codex directly via terminal!

---

🚀 Installation

Prerequisites

• Node.js (v18+) - Download

Install Steps

1. Clone or download this repository
2. Double-click install.bat (Windows) or run:

   npm install && npm run build
   

3. Done!

---

🔌 MCP Registration

💡 Replace <install-path> with your actual installation path.

Claude Code

claude mcp add ai-collab-memory -- node "<install-path>/AI-Collab-Memory/dist/index.js"

Codex (~/.codex/config.toml)

[mcp_servers.ai-collab-memory]
command = "node"
args = ["<install-path>/AI-Collab-Memory/dist/index.js"]

Antigravity / Claude Desktop (JSON)

{
  "mcpServers": {
    "ai-collab-memory": {
      "command": "node",
      "args": ["<install-path>/AI-Collab-Memory/dist/index.js"]
    }
  }
}

---

🛠️ Tools (7)

Work Log

Tool	Description
log_work	Save work record
get_work_log	View work logs

Research

Tool	Description
save_research	Save research results
search_research	Search research

Checkpoint (Save Point)

Tool	Description
save_checkpoint	Save current state (for recovery)
load_checkpoint	Load saved state

Status

Tool	Description
memory_status	View overall status

---

📖 Usage Examples

Log work

"Log this work. Claude Code created the API."

Save research

"Save this research result."

Save checkpoint (before interruption)

"Save checkpoint now. I'll continue tomorrow."

Resume work

"Load the last checkpoint."

Check status

"Show memory status."

---

💡 Key Use Cases

Case 1: Recovery After Interruption

1. During work
   → "Save checkpoint"

2. (Computer shuts down / Session disconnects)

3. Next day
   → "Load last checkpoint"
   → See progress + next steps
   → Resume immediately!

Case 2: Track Collaboration History

1. Claude Code: Finished API development
   → "Log this work"

2. Codex: Frontend development
   → "Log this work"

3. Later
   → "Show work log"
   → See who did what at a glance

Case 3: Share Research

1. Antigravity: Research React 18
   → "Save research"

2. Claude Code: When writing code
   → "Search React research"
   → Use already researched content!

---

📁 Project Structure

AI-Collab-Memory/
├── src/
│   └── index.ts           ← MCP server source (7 tools)
├── data/                  ← Runtime data (auto-created, git-ignored)
│   ├── work_log.json
│   ├── research.json
│   └── checkpoint.json
├── dist/                  ← Build output (auto-generated)
├── install.bat            ← Windows one-click installer
├── package.json
├── tsconfig.json
├── SKILL.md               ← Claude Skill definition
├── README.md              ← English docs (this file)
├── README.ko.md           ← Korean docs
└── LICENSE

---

📄 License

MIT License. See LICENSE for details.

👤 Author

Sodam AI Studio