memorax-ai/memorax-code

MemoraX Code – AI 코딩 어시스턴트를 위한 지속적인 컨텍스트

무엇인가요 – GitHub Codex, Anthropic Claude Code, DeepSeek Harness, OpenCode와 같은 대규모 언어 모델 기반 코딩 에이전트에 공유되고 클라우드 기반의 메모리 계층을 추가하는 npm 배포 도구입니다. 개발 교훈, 아키텍처 맵, 사용자 선호도, 재사용 가능한 절차를 별도의 채팅 세션 간에 기록하고 재사용하여, 어시스턴트가 중단된 지점에서 다시 작업할 수 있도록 합니다.

작동 방식

• 메모리 유형 – 네 가지 범위 지정된 저장소:
  1. 코딩 메모리 – 재사용 가능한 교훈, 수정 사항, 설계 근거.
  2. 리포지토리 메모리 – 리포지토리 수준의 사실 (모듈 소유자, 진입점, 최근 PR/커밋).
  3. 개인 메모리 – 사용자 고유의 선호도 (톤, 언어, 출력 형식).
  4. 절차 메모리 – 반복되는 작업을 위한 체크리스트 및 재사용 가능한 단계.
• 도구는 로컬에서 CLI(memorax-code)로 실행되며 API 키를 통해 MemoraX 클라우드 서비스와 통신합니다. 계정 없이 90일 간의 게스트 모드도 사용 가능합니다.
• 코딩 에이전트가 한 턴을 마치면, MemoraX Code는 핵심 지시사항과 에이전트의 최종 응답을 추출하여 적절한 메모리 저장소에 간결한 항목을 기록합니다. 전체 대화 기록은 업로드되지 않습니다.
• 에이전트는 필요 시(예: Claude Code에서는 /$memorax-code) 메모리를 검색하거나, 시스템이 일치하는 컨텍스트를 감지하면 자동으로 가져옵니다.

주요 기능

기능	얻을 수 있는 이점
백그라운드 메모리 자동 저장	교훈이 자동으로 저장되며 수동 태그 지정 필요 없음
선호도 지속성	선호하는 톤, 언어, 출력 스타일이 세션 간에 유지됨
절차 재사용	저장된 체크리스트가 유사한 미래 작업에 제안됨
리포지토리 전체 지식 기반	아키텍처 다이어그램, 진입점, 최근 이슈/PR 데이터가 최신 상태 유지
활성 메모리 제어	CLI 명령어로 수동으로 검색, 추가, 삭제 가능
다중 클라이언트 통합	Codex, Claude Code, DeepSeek Harness, OpenCode와 호환; 지원되는 곳에서는 할당량 알림 표시

시작하기

1. 전역 설치 – npm install -g @memorax/memorax-code (Node 20+, 리포지토리 메모리 기능은 Python 3 필요).
2. 연결 – memorax-code setup 실행 (게스트 계정 생성) 또는 MemoraX 계정 생성 후 API 키 제공 후 memorax-code setup --existing-account 실행.
3. 사용 – 지원되는 AI 코딩 클라이언트에서 기술 호출 ($memorax-code 또는 /memorax-code). 도구는 자동으로 컨텍스트를 캡처하고, 동일한 리포지토리에서 새 세션을 시작할 때 나중에 가져옵니다.

일반 워크플로우

# 어시스턴트가 작업할 리포지토리 클론
git clone https://github.com/SWE-agent/test-repo.git && cd test-repo

# AI 클라이언트에서 리포지토리 메모리 구축을 위해 기술 실행
$memorax-code   # (Claude Code에서는 /memorax-code)

# 몇 번의 대화 후 어시스턴트는 교훈을 저장합니다.
# 대화를 닫고 새 세션을 열어 다음을 묻습니다:
$memorax-code "엔지니어링 교훈을 기억하고 검사 항목을 제안해 주세요"

어시스턴트는 저장된 교훈을 가져와 다음 작업을 안내합니다.

관리

• memorax-code status – 현재 설정 및 클라우드 연결 확인.
• memorax-code uninstall – 로컬 데이터(~/.memorax-code)를 유지한 채 통합을 정리.
• 모든 메모리는 MemoraX 콘솔(https://platform.memorax.net/)에서 확인, 편집, 삭제 가능.

보안 및 프라이버시

• 클라우드에 전송되는 것은 사용자 지시사항과 최종 에이전트 응답의 일부만입니다. 원본 모델 자격 증명과 전체 추적은 로컬에 유지됩니다.
• API 키는 ~/.memorax-code/config.toml에 저장되며 비공개로 유지해야 합니다.
• 네트워크 및 보관 정책에 대한 자세한 내용은 SECURITY.md에 기록되어 있습니다.

누가 혜택을 받는가

• 과거 수정 사항, 아키텍처 결정, 개인적인 코딩 스타일을 기억하고 싶은 AI 페어 프로그래머에 의존하는 개발자.
• 여러 프로젝트에서 여러 AI 코딩 에이전트를 사용하고 일관된 지식 기반을 필요로 하는 팀.
• 반복적인 프롬프트를 줄이고 AI 기반 코드 리뷰 또는 기능 구현의 효율성을 높이고자 하는 누구나.

라이선스 – MIT.