Repolode
akitaonrails

akitaonrails/ai-memory

Claude Code, Codex, Cursor 등 여러 에이전트 CLI에서 프로젝트 맥락과 작업 인수인계를 이어 주는 AI 코딩 에이전트용 장기 메모리

스타
10,811
포크
765
열린 이슈
11
마지막 커밋
그저께

어떤 프로젝트인가요?

ai-memory는 AI 코딩 에이전트를 위한 장기 메모리 계층입니다. Claude Code 같은 에이전트에서 작업을 멈춘 뒤 같은 프로젝트에서 OpenAI Codex 같은 다른 에이전트를 열면, 새 에이전트가 작업이 어디까지 진행됐는지, 무엇이 실패했는지, 아직 해결되지 않은 일은 무엇인지 담은 인수인계 내용을 받습니다. 따라서 매번 아키텍처를 다시 설명할 필요가 없습니다.

라이프사이클 훅이 프롬프트, 도구 호출, 세션 경계를 수집하고 저장 전에 민감 정보를 정리한 뒤, 각 세션을 Git으로 관리되는 위키의 Markdown 페이지로 통합합니다. 위키가 기준 데이터이며 검색에 사용하는 SQLite 인덱스는 해당 파일로부터 다시 만들 수 있습니다. 검색 결과에는 전문 검색, 엔티티 및 그래프 매칭, 선택적 벡터 검색을 결합합니다. 기본 설정에서는 LLM을 호출하지 않으며, 더 나은 요약과 의미 검색을 위해 LLM 제공자를 구성할 수 있습니다.

서버는 개인 컴퓨터, 홈랩 호스트 또는 LAN 서버에서 실행할 수 있으며, 사용자별 인증과 감사 로그를 통해 팀과 공유할 수도 있습니다. 단일 Rust 바이너리로 제공되며, 설치 스크립트, Docker, NixOS 모듈 또는 Arch와 Fedora용 패키지로 설치할 수 있습니다.

핵심 기능

  • 01Claude Code, Codex, Cursor, Gemini CLI를 포함한 20개 이상의 에이전트 CLI 간에 인수인계 내용을 공유합니다.
  • 02Git으로 관리되는 위키에 일반 Markdown 파일로 메모리를 저장하며, 파일을 직접 편집할 수 있습니다.
  • 03라이프사이클 훅으로 내용을 자동 수집하고 저장 전에 민감 정보를 정리합니다.
  • 04기본적으로 LLM 호출 없이 작동하며, LLM 및 임베딩 제공자는 선택 사항입니다.
  • 05팀 사용을 위해 다중 사용자 인증, 사용자별 작업 기록, 감사 로그를 제공합니다.

활용 사례

  • 같은 저장소에서 Claude Code와 Codex를 번갈아 사용하면서 맥락을 유지합니다.
  • 홈랩 서버에 프로젝트 메모리를 공유해 두고 노트북에서 작업을 이어갑니다.
  • 모든 개발자의 에이전트가 검색할 수 있는 공통 감사 가능 지식 기반을 팀에 제공합니다.
  • 에이전트의 사용량 한도에 도달하거나 인수인계 내용을 작성하기 전에 종료된 뒤에도 작업을 이어갑니다.

빠른 시작

  1. 1

    Linux 또는 macOS에 바이너리를 설치합니다

    README의 공식 안내에 따라 설치
  2. 2

    데이터 디렉터리, 서비스, 에이전트 연결을 설정합니다

    ai-memory setup
  3. 3

    에이전트를 다시 시작한 다음 에이전트 하나에 프로젝트에 대해 기억하는 내용을 물어봅니다

사용 전 알아둘 점

  • Windows 네이티브 지원은 실험 단계이며, 지원되는 방법은 WSL2입니다.
  • 일부 에이전트는 MCP 전용, 훅 전용 또는 관리형 환경 전용으로 부분 통합되어 있습니다.
  • 컴퓨터 간 또는 팀 내에서 메모리를 공유하려면 직접 서버를 실행해야 합니다.

토픽

자주 묻는 질문

ai-memory은(는) 무엇인가요?
Claude Code, Codex, Cursor 등 여러 에이전트 CLI에서 프로젝트 맥락과 작업 인수인계를 이어 주는 AI 코딩 에이전트용 장기 메모리 ai-memory는 AI 코딩 에이전트를 위한 장기 메모리 계층입니다. Claude Code 같은 에이전트에서 작업을 멈춘 뒤 같은 프로젝트에서 OpenAI Codex 같은 다른 에이전트를 열면, 새 에이전트가 작업이 어디까지 진행됐는지, 무엇이 실패했는지, 아직 해결되지 않은 일은 무엇인지 담은 인수인계 내용을 받습니다. 따라서 매번 아키텍처를 다시 설명할 필요가 없습니다.
ai-memory은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
ai-memory은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
ai-memory은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. ai-memory의 마지막 커밋은 2026년 10월 19일입니다.
ai-memory은(는) 어디에 사용할 수 있나요?
같은 저장소에서 Claude Code와 Codex를 번갈아 사용하면서 맥락을 유지합니다. 홈랩 서버에 프로젝트 메모리를 공유해 두고 노트북에서 작업을 이어갑니다. 모든 개발자의 에이전트가 검색할 수 있는 공통 감사 가능 지식 기반을 팀에 제공합니다. 에이전트의 사용량 한도에 도달하거나 인수인계 내용을 작성하기 전에 종료된 뒤에도 작업을 이어갑니다.
ai-memory는 어떻게 설치하나요?
Linux 또는 macOS에 바이너리를 설치합니다 데이터 디렉터리, 서비스, 에이전트 연결을 설정합니다: ai-memory setup 에이전트를 다시 시작한 다음 에이전트 하나에 프로젝트에 대해 기억하는 내용을 물어봅니다
ai-memory은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/akitaonrails/ai-memory

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트