π [νκ΅μ΄](README.ko.md) | [English](README.md)
# π§ AI-Collab-Memory
> **AI νμ
κΈ°μ΅ μ μ₯μ** - μμ
λ‘κ·Έ, 리μμΉ κ³΅μ , μ€λ¨ μ 볡ꡬλ₯Ό μν MCP μλ²
[](LICENSE)
[](https://nodejs.org)
[](https://www.typescriptlang.org)
[](https://modelcontextprotocol.io)
---
## β οΈ μ΄κ±΄ λκ³ , λκ° μλκ°?
| O (κ°λ₯) | X (λΆκ°λ₯) |
|----------|-----------|
| μμ
κΈ°λ‘ μ μ₯ | μ€μκ° AI κ° ν΅μ |
| 리μμΉ κ²°κ³Ό 곡μ | μλ λͺ
λ Ή μ λ¬ |
| μ€λ¨ ν 볡ꡬ (μΈμ΄λΈ ν¬μΈνΈ) | AIκ° λ€λ₯Έ AIλ₯Ό κΉ¨μμ μ€ν |
| λκ° λ νλμ§ μΆμ | |
**μ€μκ° νμ
μ?** β Antigravityκ° ν°λ―Έλλ‘ Claude Code/Codex μ§μ νΈμΆ!
---
## π μ€μΉνκΈ°
### μ¬μ μꡬμ¬ν
- **Node.js** (v18 μ΄μ) - [λ€μ΄λ‘λ](https://nodejs.org)
### μ€μΉ λ°©λ²
1. μ΄ μ μ₯μλ₯Ό ν΄λ‘ νκ±°λ λ€μ΄λ‘λ
2. `install.bat` λλΈν΄λ¦ (Windows) λλ:
```bash
npm install && npm run build
```
3. μλ£!
---
## π MCP λ±λ‘
> π‘ `<μ€μΉκ²½λ‘>`λ₯Ό μ€μ μ€μΉν κ²½λ‘λ‘ λ³κ²½νμΈμ.
### Claude Code
```bash
claude mcp add ai-collab-memory -- node "<μ€μΉκ²½λ‘>/AI-Collab-Memory/dist/index.js"
```
### Codex (`~/.codex/config.toml`)
```toml
[mcp_servers.ai-collab-memory]
command = "node"
args = ["<μ€μΉκ²½λ‘>/AI-Collab-Memory/dist/index.js"]
```
### Antigravity / Claude Desktop (JSON)
```json
{
"mcpServers": {
"ai-collab-memory": {
"command": "node",
"args": ["<μ€μΉκ²½λ‘>/AI-Collab-Memory/dist/index.js"]
}
}
}
```
---
## π οΈ λꡬ λͺ©λ‘ (7κ°)
### μμ
λ‘κ·Έ
| λꡬ | μ€λͺ
|
|------|------|
| `log_work` | μμ
κΈ°λ‘ μ μ₯ |
| `get_work_log` | μμ
λ‘κ·Έ μ‘°ν |
### 리μμΉ
| λꡬ | μ€λͺ
|
|------|------|
| `save_research` | 리μμΉ κ²°κ³Ό μ μ₯ |
| `search_research` | 리μμΉ κ²μ |
### 체ν¬ν¬μΈνΈ (μΈμ΄λΈ ν¬μΈνΈ)
| λꡬ | μ€λͺ
|
|------|------|
| `save_checkpoint` | νμ¬ μν μ μ₯ (μ€λ¨ λλΉ) |
| `load_checkpoint` | μ μ₯λ μν λΆλ¬μ€κΈ° |
### νν©
| λꡬ | μ€λͺ
|
|------|------|
| `memory_status` | μ 체 νν© μ‘°ν |
---
## π μ¬μ© μμ
### μμ
κΈ°λ‘νκΈ°
> "μ΄ μμ
λ‘κ·Έμ κΈ°λ‘ν΄μ€. Claude Codeκ° API λ§λ€μμ΄."
### 리μμΉ μ μ₯νκΈ°
> "μ΄ λ¦¬μμΉ κ²°κ³Ό μ μ₯ν΄μ€."
### 체ν¬ν¬μΈνΈ μ μ₯ (μ€λ¨ λλΉ)
> "μ§κΈ μν 체ν¬ν¬μΈνΈλ‘ μ μ₯ν΄. λ΄μΌ μ΄μ΄μ νλ €κ³ ."
### μ΄μ΄μ μμ
νκΈ°
> "λ§μ§λ§ 체ν¬ν¬μΈνΈ λΆλ¬μμ€."
### νν© νμΈ
> "λ©λͺ¨λ¦¬ νν© λ³΄μ¬μ€."
---
## π‘ ν΅μ¬ μ¬μ© μλ리μ€
### μλλ¦¬μ€ 1: μμ
μ€λ¨ λλΉ
```
1. μμ
μ§ν μ€
β "μ§κΈ μν 체ν¬ν¬μΈνΈλ‘ μ μ₯ν΄"
2. (μ»΄ν¨ν° κΊΌμ§ / μΈμ
λκΉ)
3. λ€μ λ
β "λ§μ§λ§ 체ν¬ν¬μΈνΈ λΆλ¬μ"
β μ΄λκΉμ§ νλμ§ + λ€μ ν μΌ νμΈ
β λ°λ‘ μ΄μ΄μ μμ
!
```
### μλλ¦¬μ€ 2: νμ
κΈ°λ‘ μΆμ
```
1. Claude Code: API κ°λ° μλ£
β "μμ
λ‘κ·Έμ κΈ°λ‘ν΄"
2. Codex: νλ‘ νΈμλ κ°λ°
β "μμ
λ‘κ·Έμ κΈ°λ‘ν΄"
3. λμ€μ νμΈ
β "μμ
λ‘κ·Έ 보μ¬μ€"
β λκ° λ νλμ§ νλμ νμ
```
### μλλ¦¬μ€ 3: 리μμΉ κ³΅μ
```
1. Antigravity: React 18 리μμΉ
β "리μμΉ μ μ₯ν΄"
2. Claude Code: μ½λ μμ±ν λ
β "React 리μμΉ κ²μν΄"
β μ΄λ―Έ μ‘°μ¬λ λ΄μ© νμ©!
```
---
## π νλ‘μ νΈ κ΅¬μ‘°
```
AI-Collab-Memory/
βββ src/
β βββ index.ts β MCP μλ² μμ€ (λꡬ 7κ°)
βββ data/ β λ°νμ λ°μ΄ν° (μλ μμ±, git μ μΈ)
β βββ work_log.json
β βββ research.json
β βββ checkpoint.json
βββ dist/ β λΉλ κ²°κ³Όλ¬Ό (μλ μμ±)
βββ install.bat β Windows μν΄λ¦ μ€μΉ
βββ package.json
βββ tsconfig.json
βββ SKILL.md β Claude μ€ν¬ μ μ
βββ README.md β μλ¬Έ λ¬Έμ
βββ README.ko.md β νκΈ λ¬Έμ (μ΄ νμΌ)
βββ LICENSE
```
---
## π λΌμ΄μ μ€
MIT License. μμΈν λ΄μ©μ [LICENSE](LICENSE)λ₯Ό μ°Έμ‘°νμΈμ.
## π€ μ μ
**μλ΄ AI μ€νλμ€**