본문으로 건너뛰기
ai-memory
EnglishPortuguês (Brasil)Españolעברית日本語한국어
메뉴

제품

솔루션

연동

개발자

언어

시작하기GitHub

연동

쓰는 에이전트, 쓰는 OS, 쓰는 제공자 그대로

35개 코딩 에이전트와 에디터, 4개 운영체제 대상, 선택 사항인 모델 제공업체를 지원합니다. 캡처, 인수인계, 검색은 클라우드 모델 제공업체 없이 작동합니다.

내 에이전트 찾기빠른 설치로 이동

훅은 캡처하고, MCP는 답합니다

훅은 세션 이벤트를 자동으로 기록합니다. MCP(Model Context Protocol)는 에이전트에 기억을 검색하고 사용하는 도구를 제공합니다. 완전히 지원하는 에이전트에는 두 연결이 모두 있습니다.

훅

내 에이전트

기억

자동 캡처

MCP

내 에이전트

기억

에이전트가 호출하는 도구

훅

세션 이벤트가 작은 명령을 실행해 프롬프트와 제한된 도구 관찰 기록을 저장합니다. 인식한 자격 증명은 저장 전에 마스킹하며, 필터링은 best effort 방식입니다.

MCP

MCP를 통해 에이전트는 검색, 페이지 읽기와 쓰기, 인수인계 수령을 할 수 있습니다. MCP 전용 에이전트도 이 도구를 사용할 수 있지만 자동 세션 캡처에는 훅이 필요합니다.

에이전트는 여럿, 기억은 하나

모든 에이전트가 같은 서버에 연결됩니다. 오늘 아침 Claude Code가 알게 된 내용은 오후에 Codex를 열어도 그대로 있습니다.

Claude Code

Codex

Cursor

하나의 기억

Gemini CLI

OpenCode

Zed

에이전트와 에디터

상태로 필터링한 다음, 행을 선택하면 설치 명령어가 나옵니다.

Claude Code 지원

Claude Code
# ai-memory로 실행, 첫 실행 때 훅과 MCP 항목 설치
ai-memory run claude

# 또는 직접 연결, 이 방식으로는 실행하지 않는 하네스에 사용
ai-memory install-mcp --client claude-code --apply
ai-memory install-hooks --agent claude-code --apply

훅과 MCP. 세션 인식 라우팅은 선택 사항. --apply를 빼면 변경 내용을 쓰지 않고 출력만 합니다.

지원하는 코딩 에이전트와 에디터
에이전트상태비고ai-memory run
지원훅과 MCP. 세션 인식 라우팅은 선택 사항.관리형 실행
지원훅과 MCP. 세션 종료는 Codex CLI 0.145.0부터 연결됩니다.관리형 실행
지원MCP 설정과 라이프사이클 훅.직접 실행
지원MCP 설정과 라이프사이클 훅.직접 실행
지원V1과 V2를 실행 파일로 감지합니다.관리형 실행
지원캡처가 동작합니다. 인수인계는 첫 도구 호출과 함께 도착합니다.관리형 실행
지원훅 이벤트 10종과 MCP. 인수인계는 세션 시작 때 Copilot의 추가 컨텍스트(additional context)로 도착합니다.관리형 실행
지원MCP와 훅 이벤트 7개를 Droid 자체 파일에 설정합니다. 세션은 Droid가 직접 닫습니다.직접 실행
지원훅과 MCP. 컴팩션 이후 캡처도 포함합니다.직접 실행
지원훅 이벤트 10종. 인수인계는 첫 프롬프트에 주입됩니다.관리형 실행
지원v2와 v3 엔진 모두 지원. ai-memory run 아래에서는 종료 시 닫힙니다.관리형 실행
지원MCP와 훅 이벤트 4종, 네이티브 resume 지원. ai-memory run 아래에서는 종료 시 닫힙니다.관리형 실행
지원세션 시작, 대화 기록에서 읽는 프롬프트, 턴이 끝날 때의 체크포인트를 지원합니다. finalize-session으로 대화를 바로 닫을 수 있습니다.관리형 실행
지원자동 생성되는 확장이 캡처와 MCP 브리지를 제공합니다.관리형 실행
지원네이티브 MCP와 TypeScript 확장.관리형 실행
지원MCP 설정과 네이티브 플러그인 훅.직접 실행
지원하위 에이전트 이벤트도 캡처합니다. Zero의 전역 샌드박스 설정에서 네트워크와 ai-memory 데이터 디렉터리 쓰기를 허용하거나, 일반 셸에서 ai-memory hook-drain을 실행해 대기 중인 이벤트를 전송합니다.직접 실행
지원트리거 6종. 인수인계 주입이 동작합니다.직접 실행
지원자체 ai-memory 브리지를 갖춘 네이티브 macOS 에이전트 앱입니다. 설치할 것이 없습니다.직접 실행
MCP 전용MCP 전용. Prime Agent는 AI_MEMORY_AUTH_TOKEN을 export해야만 서버를 모델에 노출합니다.직접 실행
Hooks + MCPHooks와 MCP 모두 병합할 Cordis 패치 조각으로 출력됩니다. 세션 종료 이벤트가 없으므로 finalize-session으로 닫습니다.직접 실행
Hooks + MCPCLI 이벤트 파일 아홉 개와 Streamable HTTP 항목을 모두 써 줍니다. 작업 hook이 분리된 채 시작하므로 핸드오프는 MCP로 받습니다. yolo 모드에서는 hook이 꺼집니다.직접 실행
MCP 전용MCP 전용. FreeBuff가 원래 찾는 ~/.agents/mcp.json에 stdio bridge 항목을 씁니다.직접 실행
관리형 실행 전용ai-memory run crush로 실행하세요.관리형 실행
지원Bob IDE와 Shell용 MCP 및 네이티브 훅. 관리형 실행기와 과거 대화 기록 가져오기는 지원하지 않습니다. 마지막 턴 후 ai-memory finalize-session --agent ibm-bob를 실행하세요. Stop은 턴 경계일 뿐입니다.직접 실행
훅 전용네이티브 훅과 세션 시작 핸드오프를 지원합니다. MCP 설치기, 관리형 실행기, 과거 대화 기록 가져오기는 없습니다. 문서의 페이로드로 검증했으며 실제 클라이언트의 종단 간 검증은 아직 남아 있습니다.직접 실행
훅 전용생성된 훅 스니펫을 설정에 붙여 넣으세요.직접 실행
MCP 전용Chat은 macOS, Windows, Linux(베타)에서 mcp-remote를 사용합니다. Code 탭의 로컬 세션은 Claude Code 훅을 사용합니다. ai-memory install-hooks --agent claude-code --apply로 설치합니다. Cowork의 캡처는 검증되지 않았습니다.직접 실행
MCP 전용Copilot은 아직 라이프사이클 훅을 제공하지 않습니다.직접 실행
MCP 전용컨텍스트 서버로 등록됩니다.직접 실행
MCP 전용프로젝트 단위 MCP 설정.직접 실행
지원훅 이벤트 8개와 세션을 인식하는 MCP 브리지를 Muse 자체 설정 파일에 병합합니다.직접 실행
지원~/.qwen/settings.json에 라이프사이클 이벤트 열 개와 Streamable HTTP 항목을 씁니다. Qwen은 실제 세션 종료 이벤트를 보내므로 따로 종료할 필요가 없습니다.직접 실행
지원Qoder CLI와 IDE: 생명주기 hook 이벤트 8개와 세션 ID가 필요 없는 MCP 브리지를 설정 파일에 등록합니다. 설치 후 Qoder를 다시 시작해야 합니다. 관리형 실행기와 대화 기록 가져오기는 지원하지 않습니다.직접 실행
지원~/.hermes/config.yaml에 붙여 넣을 블록을 출력합니다. 라이프사이클 이벤트 여섯 개와 MCP 항목입니다. 커뮤니티 플러그인이 설치돼 있으면 도구 이벤트 두 개만 출력합니다.직접 실행

각 상태의 의미

지원
라이프사이클 훅으로 자동 캡처하고, MCP로 메모리 도구를 제공합니다.
Hooks + MCP
캡처와 메모리 도구가 모두 동작합니다. 다만 둘 중 하나는 설정 파일을 직접 병합해야 하거나, 다른 에이전트들이 보내는 이벤트 하나가 빠져 있습니다.
MCP 전용
에이전트가 기억을 검색하고 쓸 수 있습니다. 라이프사이클 훅을 제공하지 않아 자동으로 캡처되는 것은 없습니다.
훅 전용
세션이 자동으로 캡처됩니다. 에이전트에 기억을 조회할 MCP 클라이언트가 없습니다.
관리형 실행 전용
ai-memory run으로 실행할 때 동작합니다. 별도의 훅 설치 프로그램은 없습니다.
커뮤니티
커뮤니티가 유지하는 플러그인이며, ai-memory가 직접 설치하지 않습니다.
실험적
릴리스에 포함되어 있고 동작하지만, 거친 부분이 있다는 점은 감안해야 합니다.

에이전트별 세부 사항, 설정 파일 위치, 알려진 특이 사항은 지원 매트릭스와 MCP 설치 가이드에 있습니다.

Claude Code와 Codex: 마켓플레이스 플러그인

같은 훅, MCP 도구, 스킬을 플러그인으로도 받을 수 있습니다. 바이너리는 여전히 먼저 설치하며, 플러그인은 그것을 연결하기만 합니다.

바이너리를 설치한 뒤
claude plugin marketplace add akitaonrails/ai-memory && claude plugin install ai-memory@ai-memory
codex plugin marketplace add akitaonrails/ai-memory && codex plugin add ai-memory@ai-memory

Codex는 /hooks에서 훅을 한 번 신뢰하도록 요청하며, 이 신뢰는 업그레이드 후에도 유지됩니다. 플러그인과 설정 파일 훅이 모두 설치되어 있으면 설정 파일의 훅이 우선합니다.

Claude Code를 샌드박스 안에서 혼자 실행하기

--dangerously-skip-permissions를 써도 Claude Code는 계속 질문을 띄우므로, 누군가 자리를 지키고 앉아 하나하나 답해야 합니다. 모든 질문을 한꺼번에 꺼버리는 것은 실제로 위험한 선택입니다. ai-memory run --yolo는 무엇을 해제하려는지 미리 알려주고, ai-jail을 쓸 수 있으면 세션을 그 안에서 다시 실행할지 물어봅니다. --true-yolo는 여기에 Claude Code의 권한 우회 모드를 더하는 것으로, 직접 설정한 ask 규칙과 Claude Code의 명령어 안전성 검사는 그대로 적용됩니다.

  • 경고가 바뀌는 점을 알려줍니다

    질문이 없으면 에이전트가 파일을 삭제하고, 어떤 명령이든 실행하고, 네트워크에도 접근할 수 있습니다. 동의하기 전에 그 내용을 먼저 읽습니다.

  • ai-jail이 세션을 가둡니다

    Linux에서는 Landlock과 seccomp를 적용한 bubblewrap을, macOS에서는 sandbox-exec를 사용합니다. 예라고 답하면 체크리스트로 호스트의 어떤 자격 증명을 ai-jail에 넘길지 고를 수 있고, 아니요라고 답하면 세션은 울타리 밖에서 그대로 실행됩니다.

  • 사람에게만 묻습니다

    질문은 실제 터미널에서만 나타납니다. 훅, CI, 터미널이 없는 분리 실행이나 파이프 실행은 중단되지 않으며, 이미 ai-jail 안에 있는 세션에는 같은 질문을 다시 하지 않습니다.

런처 작동 방식ai-jail 소개
내 터미널
ai-memory run --true-yolo claudeINFO ai_memory_cli: ai-memory starting version="3.4.0" bind=127.0.0.1:49374--yolo runs every tool call with no confirmation. An agent can delete files, run any command, and reach the network unsupervised.Proceed? [Y/n] yai-jail is installed. Re-run this session inside it? [Y/n] y

ai-jail이 설치된 Linux 또는 macOS. --jail은 합리적인 기본값으로 곧바로 들어가며 --yolo가 필요 없고, --no-jail은 경고는 유지하되 제안은 건너뜁니다.

운영체제

플랫폼마다 Rust 바이너리 하나입니다. Windows에서는 WSL2가 지원 경로이고 네이티브 빌드는 실험적입니다.

지원하는 운영체제
플랫폼상태설치 방법비고
Linux지원릴리스 tarball, Docker 또는 Podman 이미지, AUR 패키지, 또는 Fedora RPMx86_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 래퍼, 또는 소스 빌드. zip은 ai-memory upgrade로 스스로 업그레이드됩니다.
NixOS지원Flake 패키지, 또는 시스템 서비스로 쓰는 NixOS 모듈Flake 패키지와, 보안을 강화한 systemd 유닛을 갖춘 NixOS 모듈. 시크릿은 agenix, sops-nix 또는 환경 변수 파일로 다룹니다.

최신 릴리스 다운로드Windows 가이드 읽기

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
  • Anthropic OAuth(Claude 구독 토큰은 현재 타사 앱에서 거부됨)
  • OpenAI
  • OpenAI OAuth / Codex CLI 로그인
  • GitHub Copilot
  • Cursor(Cursor 구독, 에이전트 CLI 경유)
  • Google Gemini
  • OpenCode Go와 Zen
  • Ollama
  • LM Studio
  • vLLM
  • OpenRouter와 OpenAI 호환 엔드포인트 전부

제공자는 ai-memory llm-test로 확인합니다. 폴백 체인을 지원합니다. 통합, bootstrap, 재랭킹, 질의 답변 등 LLM 작업마다 각자의 제공자와 체인을 지정할 수 있습니다.

모델, 기본값, 비용은 LLM 제공자 가이드와 로컬 임베딩 가이드에 있습니다.

쓰는 에이전트가 목록에 없나요?

MCP를 지원하기만 하면 지금 바로 메모리 도구를 쓸 수 있습니다.

에이전트 설정에서 이 주소로 원격 HTTP MCP 서버를 등록하세요. 검색, 페이지 읽기와 쓰기, 인수인계가 모두 동작합니다. 자동 캡처에는 라이프사이클 훅이 필요하므로, 훅이 없으면 에이전트는 자기가 쓴 것만 기억합니다.

Warp, Cline, Kilo Code, Goose, Qwen Code, OpenHuman은 각 클라이언트의 공식 문서에 따라 작성한 설치 레시피가 설치 가이드에 있습니다. 아직 끝까지 실행해 본 곳은 없습니다.

완전한 지원을 원하시나요? 관리형 하네스 기여 가이드에 어댑터가 증명해야 할 것이 설명되어 있고, 기여하기 페이지에 이슈와 풀 리퀘스트를 어디에 올리는지 나와 있습니다.

MCP 엔드포인트
# 기본 로컬 서버
http://127.0.0.1:49374/mcp

자주 묻는 질문

ai-memory는 어떤 코딩 에이전트와 함께 동작하나요?

Claude Code, Codex, Cursor, Gemini CLI, OpenCode 등 에이전트와 에디터 35종이 목록에 있습니다. 그중 24종은 라이프사이클 훅을 통한 자동 캡처와 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으로 제공됩니다.

이어서 읽기

오늘 에이전트에 기억을 달아 주세요.

MIT 라이선스의 무료 오픈 소스입니다. 기본 기억 기능에는 모델 API 키가 필요 없지만, 코딩 에이전트는 별도 계정이 필요할 수 있습니다.

지금 설치하기GitHub에서 스타 주기