AI-Collab-Memory

🌏 [한국어](README.ko.md) | [English](README.md) # 🧠 AI-Collab-Memory > **AI Collaboration Memory** - MCP server for work logs, research sharing, and checkpoint recovery [](LICENSE) [](https://nodejs.org) [](https://www.typescriptlang.org) [](https://modelcontextprotocol.io) --- ## ⚠️ 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](https://nodejs.org) ### Install Steps 1. Clone or download this repository 2. Double-click `install.bat` (Windows) or run: ```bash npm install && npm run build ``` 3. Done! --- ## 🔌 MCP Registration > 💡 Replace `<install-path>` with your actual installation path. ### Claude Code ```bash claude mcp add ai-collab-memory -- node "<install-path>/AI-Collab-Memory/dist/index.js" ``` ### Codex (`~/.codex/config.toml`) ```toml [mcp_servers.ai-collab-memory] command = "node" args = ["<install-path>/AI-Collab-Memory/dist/index.js"] ``` ### Antigravity / Claude Desktop (JSON) ```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](LICENSE) for details. ## 👤 Author **Sodam AI Studio**