에이전트는 여럿, 기억은 하나
모든 에이전트가 같은 서버에 연결됩니다. 오늘 아침 Claude Code가 알게 된 내용은 오후에 Codex를 열어도 그대로 있습니다.
에이전트와 에디터
상태로 필터링한 다음, 행을 선택하면 설치 명령어가 나옵니다.
Claude Code 지원
# 메모리 도구, MCP로 제공
ai-memory install-mcp --client claude-code --apply
# 자동 캡처, 라이프사이클 훅으로 동작
ai-memory install-hooks --agent claude-code --apply
# 또는 관리형으로 실행합니다. 두 방식 모두 연결을 알아서 설정합니다
ai-memory run claude
훅과 MCP. 세션 인식 라우팅은 선택 사항. --apply를 빼면 변경 내용을 쓰지 않고 출력만 합니다.
Codex 지원
# 메모리 도구, MCP로 제공
ai-memory install-mcp --client codex --apply
# 자동 캡처, 라이프사이클 훅으로 동작
ai-memory install-hooks --agent codex --apply
# 또는 관리형으로 실행합니다. 두 방식 모두 연결을 알아서 설정합니다
ai-memory run codex
훅과 MCP. 세션 종료는 Codex CLI 0.145.0부터 연결됩니다. --apply를 빼면 변경 내용을 쓰지 않고 출력만 합니다.
Cursor 지원
# 메모리 도구, MCP로 제공
ai-memory install-mcp --client cursor --apply
# 자동 캡처, 라이프사이클 훅으로 동작
ai-memory install-hooks --agent cursor --apply
MCP 설정과 라이프사이클 훅. --apply를 빼면 변경 내용을 쓰지 않고 출력만 합니다.
Gemini CLI 지원
# 메모리 도구, MCP로 제공
ai-memory install-mcp --client gemini-cli --apply
# 자동 캡처, 라이프사이클 훅으로 동작
ai-memory install-hooks --agent gemini-cli --apply
MCP 설정과 라이프사이클 훅. --apply를 빼면 변경 내용을 쓰지 않고 출력만 합니다.
OpenCode 지원
# 메모리 도구, MCP로 제공
ai-memory install-mcp --client opencode --apply
# 자동 캡처, 라이프사이클 훅으로 동작
ai-memory install-hooks --agent opencode --apply
# 또는 관리형으로 실행합니다. 두 방식 모두 연결을 알아서 설정합니다
ai-memory run opencode
원격 MCP와 자동 생성되는 TypeScript 플러그인. --apply를 빼면 변경 내용을 쓰지 않고 출력만 합니다.
OpenCode 2 beta 지원
# 메모리 도구, MCP로 제공
ai-memory install-mcp --client opencode2 --apply
# 자동 캡처, 라이프사이클 훅으로 동작
ai-memory install-hooks --agent opencode2 --apply
# 또는 관리형으로 실행합니다. 두 방식 모두 연결을 알아서 설정합니다
ai-memory run opencode2
베타 API용 플러그인. 업스트림이 자주 바뀔 수 있습니다. --apply를 빼면 변경 내용을 쓰지 않고 출력만 합니다.
Grok Build CLI 지원
# 메모리 도구, MCP로 제공
ai-memory install-mcp --client grok --apply
# 자동 캡처, 라이프사이클 훅으로 동작
ai-memory install-hooks --agent grok --apply
# 또는 관리형으로 실행합니다. 두 방식 모두 연결을 알아서 설정합니다
ai-memory run grok
캡처가 동작합니다. 인수인계는 MCP로 받습니다. --apply를 빼면 변경 내용을 쓰지 않고 출력만 합니다.
Devin CLI 지원
# 메모리 도구, MCP로 제공
ai-memory install-mcp --client devin --apply
# 자동 캡처, 라이프사이클 훅으로 동작
ai-memory install-hooks --agent devin --apply
훅과 MCP. 컴팩션 이후 캡처도 포함합니다. --apply를 빼면 변경 내용을 쓰지 않고 출력만 합니다.
Kimi Code 지원
# 메모리 도구, MCP로 제공
ai-memory install-mcp --client kimi-code --apply
# 자동 캡처, 라이프사이클 훅으로 동작
ai-memory install-hooks --agent kimi-code --apply
# 또는 관리형으로 실행합니다. 두 방식 모두 연결을 알아서 설정합니다
ai-memory run kimi
훅 이벤트 10종. 인수인계는 첫 프롬프트에 주입됩니다. --apply를 빼면 변경 내용을 쓰지 않고 출력만 합니다.
Kiro CLI 지원
# 메모리 도구, MCP로 제공
ai-memory install-mcp --client kiro-cli --apply
# 자동 캡처, 라이프사이클 훅으로 동작
ai-memory install-hooks --agent kiro-cli --apply
# 또는 관리형으로 실행합니다. 두 방식 모두 연결을 알아서 설정합니다
ai-memory run kiro
v2와 v3 엔진 모두 지원. --apply를 빼면 변경 내용을 쓰지 않고 출력만 합니다.
Command Code 지원
# 메모리 도구, MCP로 제공
ai-memory install-mcp --client command-code --apply
# 자동 캡처, 라이프사이클 훅으로 동작
ai-memory install-hooks --agent command-code --apply
# 또는 관리형으로 실행합니다. 두 방식 모두 연결을 알아서 설정합니다
ai-memory run command-code
MCP와 훅 이벤트 4종, 네이티브 resume 지원. --apply를 빼면 변경 내용을 쓰지 않고 출력만 합니다.
Antigravity CLI 지원
# 메모리 도구, MCP로 제공
ai-memory install-mcp --client antigravity-cli --apply
# 자동 캡처, 라이프사이클 훅으로 동작
ai-memory install-hooks --agent antigravity-cli --apply
# 또는 관리형으로 실행합니다. 두 방식 모두 연결을 알아서 설정합니다
ai-memory run antigravity
세션은 finalize-session으로 닫힙니다. --apply를 빼면 변경 내용을 쓰지 않고 출력만 합니다.
Pi 지원
# 메모리 도구, MCP로 제공
ai-memory install-mcp --client pi --apply
# 자동 캡처, 라이프사이클 훅으로 동작
ai-memory install-hooks --agent pi --apply
자동 생성되는 확장이 캡처와 MCP 브리지를 제공합니다. --apply를 빼면 변경 내용을 쓰지 않고 출력만 합니다.
Oh My Pi 지원
# 메모리 도구, MCP로 제공
ai-memory install-mcp --client omp --apply
# 자동 캡처, 라이프사이클 훅으로 동작
ai-memory install-hooks --agent omp --apply
네이티브 MCP와 TypeScript 확장. --apply를 빼면 변경 내용을 쓰지 않고 출력만 합니다.
OpenClaw 지원
# 메모리 도구, MCP로 제공
ai-memory install-mcp --client openclaw --apply
# 자동 캡처, 라이프사이클 훅으로 동작
ai-memory install-hooks --agent openclaw --apply
MCP 설정과 네이티브 플러그인 훅. --apply를 빼면 변경 내용을 쓰지 않고 출력만 합니다.
Zero 지원
# 메모리 도구, MCP로 제공
ai-memory install-mcp --client zero --apply
# 자동 캡처, 라이프사이클 훅으로 동작
ai-memory install-hooks --agent zero --apply
서브에이전트 이벤트까지 캡처합니다. --apply를 빼면 변경 내용을 쓰지 않고 출력만 합니다.
ZCode 지원
# 메모리 도구, MCP로 제공
ai-memory install-mcp --client zcode --apply
# 자동 캡처, 라이프사이클 훅으로 동작
ai-memory install-hooks --agent zcode --apply
트리거 6종. 인수인계 주입이 동작합니다. --apply를 빼면 변경 내용을 쓰지 않고 출력만 합니다.
Crush 관리형 실행 전용
# ai-memory를 통해 실행합니다
ai-memory run crush
ai-memory run crush로 실행하세요.
Pool 훅 전용
# 훅 스크립트를 준비하고, 에이전트 설정에 붙여 넣을 스니펫을 출력합니다
ai-memory install-hooks --agent pool --apply
생성된 훅 스니펫을 설정에 붙여 넣으세요.
Claude Desktop MCP 전용
# 메모리 도구, MCP로 제공
ai-memory install-mcp --client claude-desktop --apply
mcp-remote를 통해 연결합니다. --apply를 빼면 변경 내용을 쓰지 않고 출력만 합니다.
VS Code Copilot MCP 전용
# 메모리 도구, MCP로 제공
ai-memory install-mcp --client vscode-copilot --apply
Copilot은 아직 라이프사이클 훅을 제공하지 않습니다. --apply를 빼면 변경 내용을 쓰지 않고 출력만 합니다.
Zed MCP 전용
# 메모리 도구, MCP로 제공
ai-memory install-mcp --client zed --apply
컨텍스트 서버로 등록됩니다. --apply를 빼면 변경 내용을 쓰지 않고 출력만 합니다.
Swival CLI MCP 전용
# 메모리 도구, MCP로 제공
ai-memory install-mcp --client swival --apply
프로젝트 단위 MCP 설정. --apply를 빼면 변경 내용을 쓰지 않고 출력만 합니다.
Muse Code MCP 전용
# 메모리 도구, MCP로 제공
ai-memory install-mcp --client muse --apply
사용자 단위 MCP 설정. --apply를 빼면 변경 내용을 쓰지 않고 출력만 합니다.
Hermes Agent 커뮤니티
ai-memory는 이 에이전트용 인스톨러를 제공하지 않습니다. 서버는 이 에이전트의 훅 이벤트를 인식하며, 플러그인은 커뮤니티가 유지 관리합니다. 설치하기 전에 직접 검토하세요. GitHub의 ai-memory-hermes-plugin.
MrLuciano가 만든 커뮤니티 플러그인.
| 에이전트 | 상태 | 비고 | ai-memory run |
|---|---|---|---|
| 지원 | 훅과 MCP. 세션 인식 라우팅은 선택 사항. | 관리형 실행 | |
| 지원 | 훅과 MCP. 세션 종료는 Codex CLI 0.145.0부터 연결됩니다. | 관리형 실행 | |
| 지원 | MCP 설정과 라이프사이클 훅. | 직접 실행 | |
| 지원 | MCP 설정과 라이프사이클 훅. | 직접 실행 | |
| 지원 | 원격 MCP와 자동 생성되는 TypeScript 플러그인. | 관리형 실행 | |
| 지원 | 베타 API용 플러그인. 업스트림이 자주 바뀔 수 있습니다. | 관리형 실행 | |
| 지원 | 캡처가 동작합니다. 인수인계는 MCP로 받습니다. | 관리형 실행 | |
| 지원 | 훅과 MCP. 컴팩션 이후 캡처도 포함합니다. | 직접 실행 | |
| 지원 | 훅 이벤트 10종. 인수인계는 첫 프롬프트에 주입됩니다. | 관리형 실행 | |
| 지원 | v2와 v3 엔진 모두 지원. | 관리형 실행 | |
| 지원 | MCP와 훅 이벤트 4종, 네이티브 resume 지원. | 관리형 실행 | |
| 지원 | 세션은 finalize-session으로 닫힙니다. | 관리형 실행 | |
| 지원 | 자동 생성되는 확장이 캡처와 MCP 브리지를 제공합니다. | 관리형 실행 | |
| 지원 | 네이티브 MCP와 TypeScript 확장. | 관리형 실행 | |
| 지원 | MCP 설정과 네이티브 플러그인 훅. | 직접 실행 | |
| 지원 | 서브에이전트 이벤트까지 캡처합니다. | 직접 실행 | |
| 지원 | 트리거 6종. 인수인계 주입이 동작합니다. | 직접 실행 | |
| 관리형 실행 전용 | ai-memory run crush로 실행하세요. | 관리형 실행 | |
| 훅 전용 | 생성된 훅 스니펫을 설정에 붙여 넣으세요. | 직접 실행 | |
| MCP 전용 | mcp-remote를 통해 연결합니다. | 직접 실행 | |
| MCP 전용 | Copilot은 아직 라이프사이클 훅을 제공하지 않습니다. | 직접 실행 | |
| MCP 전용 | 컨텍스트 서버로 등록됩니다. | 직접 실행 | |
| MCP 전용 | 프로젝트 단위 MCP 설정. | 직접 실행 | |
| MCP 전용 | 사용자 단위 MCP 설정. | 직접 실행 | |
| 커뮤니티 | MrLuciano가 만든 커뮤니티 플러그인. | 직접 실행 |
각 상태의 의미
- 지원
- 라이프사이클 훅으로 자동 캡처하고, MCP로 메모리 도구를 제공합니다.
- MCP 전용
- 에이전트가 기억을 검색하고 쓸 수 있습니다. 라이프사이클 훅을 제공하지 않아 자동으로 캡처되는 것은 없습니다.
- 훅 전용
- 세션이 자동으로 캡처됩니다. 에이전트에 기억을 조회할 MCP 클라이언트가 없습니다.
- 관리형 실행 전용
ai-memory run으로 실행할 때 동작합니다. 별도의 훅 설치 프로그램은 없습니다.- 커뮤니티
- 커뮤니티가 유지하는 플러그인이며, ai-memory가 직접 설치하지 않습니다.
- 실험적
- 릴리스에 포함되어 있고 동작하지만, 거친 부분이 있다는 점은 감안해야 합니다.
에이전트별 세부 사항, 설정 파일 위치, 알려진 특이 사항은 지원 매트릭스와 MCP 설치 가이드에 있습니다.
훅은 캡처하고, MCP는 답합니다
이 둘은 별개의 연결이며, 완전히 지원되는 에이전트는 둘 다 갖습니다. 내 에이전트가 어느 쪽을 쓰는지는 위의 상태 라벨에 나와 있습니다.
훅
에이전트의 라이프사이클 이벤트가 작은 명령을 실행해 프롬프트, 도구 호출, 세션의 시작과 끝을 기록합니다. 여러분이 할 일은 없고, 에이전트는 여기에 토큰을 쓰지 않습니다. 시크릿은 저장하기 전에 제거됩니다.
MCP
에이전트는 대화 중에 필요할 때 호출할 수 있는 메모리 도구를 얻습니다. 검색, 페이지 읽기, 페이지 쓰기, 인수인계 수락입니다. MCP 전용 에이전트도 메모리를 온전히 쓸 수 있지만, 직접 쓰지 않는 한 아무것도 캡처되지 않습니다.
운영체제
플랫폼마다 Rust 바이너리 하나입니다. Windows에서는 WSL2가 지원 경로이고 네이티브 빌드는 실험적입니다.
| 플랫폼 | 상태 | 설치 방법 | 비고 |
|---|---|---|---|
| Linux | 지원 | 릴리스 tarball, Docker 또는 Podman 이미지, 또는 AUR 패키지 | x86_64와 ARM64. 네이티브 바이너리, Docker 또는 Podman, systemd 유닛이 포함된 AUR 패키지. |
| macOS | 지원 | launchd 에이전트가 포함된 릴리스 tarball, Docker, 또는 소스에서 빌드한 메뉴 막대 앱 | Apple Silicon과 Intel. launchd 에이전트가 포함된 네이티브 바이너리, Docker, 또는 소스에서 빌드하는 메뉴 막대 앱. |
| WSL2를 통한 Windows | 지원 | WSL2 안에서 Linux 바이너리 사용 | WSL2 안에서 Linux 설치 방법을 따르고, 에이전트도 거기서 실행하세요. |
| 네이티브 Windows | 실험적 | 릴리스 zip, Docker Desktop 래퍼, 또는 소스 빌드 | ai-memory.exe가 들어 있는 릴리스 zip, Docker Desktop 래퍼, 또는 소스 빌드. |
LLM 및 임베딩 제공자
둘 다 선택 사항입니다. 둘 다 없어도 훅은 캡처하고, 검색은 동작하며, 모든 세션은 요약 페이지와 인수인계로 끝납니다.
임베딩: 기본값은 로컬
2.0부터 벡터 검색은 작은 오픈 모델로 프로세스 안에서 실행됩니다. API 키도 GPU도 필요 없습니다. 모델은 약 87 MB이고, 첫 시작 때 백그라운드에서 내려받으며, 하이브리드 검색은 다음 재시작부터 켜집니다. 다운로드에 실패해도 검색은 전문 검색으로 계속 동작합니다.
- 로컬, 인프로세스 (기본값)
- OpenAI
- Voyage
- Google Gemini
- GitHub Copilot
- Ollama, LM Studio, vLLM
끄려면 embedding_provider = "none"으로 설정합니다. 직접 설정한 제공자를 덮어쓰는 일은 없습니다.
LLM: 기본값은 꺼짐
LLM이 작성하는 통합, ai-memory bootstrap, 더 풍부한 린트, 자동 개선, 리랭킹이 필요할 때 추가하세요. 제공자가 모델을 고를 수 있게 해 준다면, 이 작업에는 작고 빠른 모델이 알맞습니다. Codex나 ChatGPT 로그인을 쓸 때는 제공자의 기본 모델을 그대로 두세요. 이 백엔드는 다른 모델 이름을 거부합니다. 구독 로그인도 되므로 유료 플랫폼 API 키가 꼭 필요하지는 않습니다.
- Anthropic
- OpenAI
- OpenAI OAuth / Codex CLI 로그인
- GitHub Copilot
- Google Gemini
- OpenCode Go와 Zen
- Ollama
- LM Studio
- vLLM
- OpenAI 호환 엔드포인트 전부
제공자는 ai-memory llm-test로 확인합니다. 폴백 체인을 지원합니다.
모델, 기본값, 비용은 LLM 제공자 가이드와 로컬 임베딩 가이드에 있습니다.
쓰는 에이전트가 목록에 없나요?
MCP를 지원하기만 하면 지금 바로 메모리 도구를 쓸 수 있습니다.
에이전트 설정에서 이 주소로 원격 HTTP MCP 서버를 등록하세요. 검색, 페이지 읽기와 쓰기, 인수인계가 모두 동작합니다. 자동 캡처에는 라이프사이클 훅이 필요하므로, 훅이 없으면 에이전트는 자기가 쓴 것만 기억합니다.
완전한 지원을 원하시나요? 관리형 하네스 기여 가이드에 어댑터가 증명해야 할 것이 설명되어 있고, 기여하기 페이지에 이슈와 풀 리퀘스트를 어디에 올리는지 나와 있습니다.
# 기본 로컬 서버
http://127.0.0.1:49374/mcp
자주 묻는 질문
ai-memory는 어떤 코딩 에이전트와 함께 동작하나요?
Claude Code, Codex, Cursor, Gemini CLI, OpenCode 등 에이전트와 에디터 25종이 목록에 있습니다. 그중 17종은 라이프사이클 훅을 통한 자동 캡처와 MCP 메모리 도구를 모두 갖추고 있습니다.
훅과 MCP는 무엇이 다른가요?
훅은 세션을 자동으로 캡처합니다. 에이전트가 아무것도 하지 않아도 프롬프트, 도구 호출, 세션의 시작과 끝이 기록됩니다. MCP는 에이전트가 메모리를 검색하고 쓸 때 호출하는 도구를 제공합니다. 완전히 지원되는 에이전트는 둘 다 갖습니다.
쓰는 에이전트가 목록에 없습니다. 그래도 쓸 수 있나요?
MCP를 지원한다면 가능합니다. http://127.0.0.1:49374/mcp 로 연결하면 메모리를 검색하고 쓸 수 있습니다. 라이프사이클 훅이 없으면 자동으로 캡처되는 것은 없습니다.
LLM이나 임베딩 제공자가 필요한가요?
아니요. 둘 다 선택 사항입니다. 2.0부터 기본 임베딩은 첫 시작 때 내려받는 약 87 MB 모델로 프로세스 안에서 실행되며, API 키는 쓰지 않습니다.
ai-memory는 Windows에서 실행되나요?
네. WSL2는 Linux 경로로 지원됩니다. 네이티브 Windows는 실험적이며 ai-memory.exe가 담긴 릴리스 zip으로 제공됩니다.