memorax-ai/memorax-code

코드 그 이상으로, 이 시스템은 사용자의 아키텍처가 어떻게 진화하고 엔지니어링이 어떻게 전개되는지를 기억합니다.

English · 简体中文

코딩 에이전트는 눈앞의 작업에는 능숙하지만, 새로운 세션이 시작될 때마다 이전 세션에서 확립했던 아키텍처, 실패한 시도들, 리포지토리 규칙, 또는 작동 선호도 등이 없는 경우가 많습니다.

MemoraX Code는 Codex, Claude Code, CodeBuddy CLI, WorkBuddy, DeepSeek Harness, OpenCode, Trae, Cursor 등에게 이러한 컨텍스트를 위한 공유 메모리 레이어를 제공합니다. 이 시스템은 이전의 엔지니어링 지식을 회상하고, 완료된 작업에서 재사용 가능한 교훈을 포착하며, 리포지토리 지식을 유지하고, 사용자의 절차와 선호도를 미래 세션으로 가져갈 수 있습니다.

목표는 모든 것을 기억하는 것이 아닙니다. 현재 작업과 관련된 적은 양의 메모리를 되살려 에이전트가 유용한 조사 및 검증에 더 빨리 도달할 수 있도록 하는 것입니다.

Node.js 20+ (Node.js 24 LTS 권장)와 Codex, Claude Code, CodeBuddy CLI, WorkBuddy, DeepSeek Harness, OpenCode, Trae, Cursor 중 하나 이상을 준비하십시오.

DeepSeek Harness (DSH)의 경우, 현재 버전은 Node.js ^22.19.0 || >=24.0.0을 요구합니다.

먼저 DSH를 설치하거나 초기화하고, 최소한 하나의 프로필(Profile)을 생성하며, setup을 실행하기 전에 pnpm이 PATH에 있는지 확인하십시오. MemoraX Code는 DSH를 설치하거나 업데이트하지 않습니다.

Linux의 경우, 게스트 자격 증명은 libsecret에서 제공하는 /usr/bin/secret-tool과 현재 사용자 세션에서 사용 가능한 Secret Service가 필요합니다. 원격 SSH(Remote SSH), WSL 또는 Dev Containers의 경우 코딩 에이전트와 동일한 환경에 MemoraX Code를 설치하십시오. MemoraX 검색 및 쓰기백(writeback) 기능은 네트워크 접근을 필요로 합니다.

npm install -g @memorax/memorax-code

이 명령어는 패키지를 설치할 뿐, 대화형 설정(interactive setup)을 시작하지 않습니다. --ignore-scripts를 사용하지 마십시오: npm 라이프사이클 스크립트는 패키지 교체 중에 실행 중인 관리형 백엔드(managed Backend)를 안전하게 중지하고 복원합니다.

MemoraX 계정을 생성하거나 기존 계정을 사용한 다음, 일반적인 대화형 터미널에서 다음을 실행하십시오:

memorax-code setup --existing-account

설정 프롬프라인에 따라 MemoraX 사용자 이름과 API 키를 로컬로 입력하십시오.

인터랙티브 터미널이 없는 코딩 에이전트의 경우, API 키를 stdin을 통해 전달하십시오. 예제들은 호출자(caller)가 이미 MEMORAX_SETUP_API_KEY를 제공한다고 가정합니다. 키를 명령어 인자나 프로젝트 파일에 넣지 마십시오.

printf '%s\n' "$MEMORAX_SETUP_API_KEY" | memorax-code setup --existing-account --non-interactive

Windows PowerShell의 경우:

$env:MEMORAX_SETUP_API_KEY | memorax-code.cmd setup --existing-account --non-interactive

이 명시적인 명령어는 저장된 키를 대체하고 감지된 로컬 사용자 이름 및 시스템 언어를 사용합니다. 로컬 구성 및 준비 확인 후 API Key match: true를 보고하며, 이는 클라우드 자격 증명(cloud credentials)을 검증하지 않습니다. 입력 및 재사용 동작에 대해서는 non-interactive setup을 참조하십시오.

팁

MemoraX Code를 여러 장치에서 사용하시나요? 설정된 장치의 구성 파일(일반적으로 ~/.memorax-code/config.toml)에서 사용자 이름과 API 키를 찾은 다음, 새 장치의 로컬 설정 터미널에 입력하십시오. 이 파일에는 API 키가 포함되어 있으므로 개인 정보로 유지하고 채팅이나 공개 이슈에 절대 붙여넣지 마십시오.

즉시 시작하고 나중에 계정을 연결하려면 다음을 실행하십시오:

memorax-code setup

기본 설정은 기존의 완전한 연결을 재사용합니다. 그렇지 않은 경우, 로컬 사용자 이름과 언어를 감지하고 필요할 때 요청하며, 게스트 자격 증명(guest credentials)을 생성하거나 복원합니다. 저장된 연결을 대체하려면 memorax-code setup --reconfigure를 사용하고, 게스트 모드용 또는 등록된 계정용으로는 memorax-code setup --existing-account를 사용하십시오.

나중에 등록할 때 게스트 메모리를 유지하려면 먼저 로컬 터미널에서 이 명령어를 직접 실행하십시오:

memorax-code account --show-mark-id

중요

Mark ID를 얻은 후 등록하고, 이를 사용하여 MemoraX에서 게스트 계정을 활성화하십시오. 플랫폼은 현재 이미 등록된 계정에 Mark ID를 연결하는 것을 지원하지 않습니다.

두 설정 경로 모두 지원되는 코딩 에이전트를 자동으로 감지합니다. 설정 후에는 감지된 모든 코딩 에이전트를 다시 시작하거나 새로 고치십시오.

; 설정은 타사 통합 설정을 유지합니다. CLI 검색(CLI Search)과 수동 추가(manual Add)를 위해 Skill을 사용하십시오. 자동 추가(Automatic Add)는 검증된 네이티브 데이터베이스 턴(native database turns)을 읽으며 Node.js 22.13 이상 및 내장 SQLite(Node.js 24 권장)가 필요합니다. 일반 프롬프트, 수정된 재전송(edited resends), 그리고 관찰된 선행 턴에 바인딩된 연속 내용을 지원합니다. 중단되었거나 모호하게 상관관계가 있는 내용은 건너뜁니다. Prompt Hooks는 첫 번째 적격 턴에서 신뢰할 수 있는 사용자 프로필 환경설정(User Profile preferences)을 주입하고, 구성된 알림 주기(reminder cadence)에 따라 절차 메모리(Procedure Memory)를 제공합니다. 기본 절차 주기는 1, 6, 11번째 턴(이후 매 5턴)입니다. 기록된 압축(compaction)이 네이티브 데이터베이스와 검증된 후, 다음 비어있지 않은 등록된 프롬프트가 프로필과 개인 알림을 복원하며; 절차는 정상 주기를 유지합니다. 누락된 증거는 복구를 건너뛰며, 동일한 연속 작업 중의 복구는 보장되지 않습니다. Repo Memory 초기 빌드 및 정책 기반 유지 관리는 Cursor의 네이티브 백그라운드 서브 에이전트(native background subagent)를 사용하며, 별도의 Cursor CLI 또는 CLI 로그인이 필요하지 않습니다. Cursor가 일반적인 도구 승인(tool approvals)을 요청할 수 있습니다. Cursor 설정을 참조하십시오.

프로젝트를 열고 새 클라이언트 세션을 시작한 다음 프롬프트 하나를 보냅니다. 그런 다음 프로젝트 디렉토리에서 다음 명령어를 실행합니다:

memorax-code --version
memorax-code status
memorax-cli status

Windows PowerShell에서는 memorax-cli.cmd status를 사용하십시오.

. 구성된 통합은 클라이언트가 Hook을 실행할 때까지 여전히 hook-runtime=unverified를 보고할 수 있습니다.
Hook이 성공적으로 실행된 후, 해당 클라이언트의 Hook 런타임(Hook runtime)은 observed로 변경되어야 합니다.

memorax-code status는 로컬 백엔드와 클라이언트 통합을 확인하며;
memorax-cli status

로컬 메모리 구성 및 워크스페이스 범위를 확인합니다.
두 명령어 모두 MemoraX에 테스트 요청을 보내지는 않습니다. 실제 검색이나 쓰기 작업을 수행해야 원격 연결성 및 자격 증명을 확인할 수 있습니다. 아래의 세션 간 예시를 따르십시오.
클라이언트별 진단 명령어는 [Troubleshooting] 섹션을 참조하십시오.

패키지 설치가 자동으로 설정을 시작하지 않습니다. 에이전트에게 상호 작용 터미널이 없는 경우 stdin 모드를 사용하여 위에 나열된 설정 명령어 중 하나를 실행하십시오. 설정이 불완전하거나 메모리가 사용 불가능한 경우에는 상태 명령어로 시작하여 [Troubleshooting]을 따르십시오.

두 명령어 모두 동일한 패키지에 포함되어 있습니다. 설정을 부트스트랩하거나 오래된 터미널 환경을 복구하려면 Windows PATH 복구 단계를 따르십시오.

제품 웹사이트에서 예제 리포지토리를 클론한 다음, 프로젝트 디렉토리에서 Codex, Claude Code, CodeBuddy CLI, WorkBuddy, DeepSeek Harness, OpenCode, Trae 또는 Cursor를 엽니다:

git clone https://github.com/SWE-agent/test-repo.git
cd test-repo

Codex에서 $memorax-code로 스킬을 호출하거나 Claude Code 또는 DeepSeek Harness에서는 /memorax-code로 호출합니다. OpenCode, CodeBuddy CLI, WorkBuddy, Trae 또는 Cursor에서는 에이전트에게 memorax-code 스킬을 이름으로 사용하도록 요청하십시오. 아래 프롬프트는 제품 이름을 사용하여 작성되었으며 모든 지원되는 클라이언트에서 작동합니다.

동일한 세션에서 다음 프롬프트를 순서대로 전송하십시오:

• MemoraX Code 스킬을 사용하여 Repo Memory를 구축하고, 최신 3개의 이슈, 풀 리퀘스트 및 커밋만 검색합니다.
• 최근 Repo Memory 이슈 검토: 제로 번째 번호는 한때 잘못 계산되었습니다. 이제 같은 문제를 반복하는 것을 피하십시오.
• MemoraX Code 스킬을 사용하여 이 코딩 작업에서 얻은 엔지니어링 교훈을 기억합니다.

현재 대화를 닫고, 동일한 리포지토리에서 새 세션을 시작한 다음 다음을 전송합니다:

MemoraX Code 스킬을 사용하여 이전 엔지니어링 교훈을 회상하고 무엇을 확인할지 제안하도록 요청하십시오.

에이전트는 저장된 교훈을 검색하여 현재 리포지토리에 대한 제안을 하는 데 사용해야 합니다.

팁

위에 제시된 프롬프트들은 빠른 검증을 위한 것일 뿐입니다. 일반적인 사용 시에는 메모리를 수동으로 추가하기 위해 MemoraX Code 스킬을 호출할 필요가 없습니다. 이 기능은 관련 메모리를 백그라운드에서 작성하며, 유용할 때 에이전트가 검색하도록 안내합니다.
로컬 활동 및 상태는 MEMORAX_CODE_HOME 아래에 콘텐츠 제어 추적(content-controlled trace) 및 조정 기록(reconciliation records)으로 유지됩니다.

개인 메모리와 절차 메모리는 $MEMORAX_CODE_HOME/personal-memory/ 아래에서 사용자에게 전역적입니다.
(기본값 ~/.memorax-code/personal-memory/):
사용자 프로필은 user-profile/preferences.md를 사용하며, 각 절차 주제는 procedure-memory/ 아래에 자체 파일을 사용합니다. 적용 가능성(Applicability)이 저장소, 도구 또는 워크플로우를 언급할 수 있지만, 저장소 내부에는 개인 메모리 계층은 존재하지 않습니다. 기존의 .repo_memory

개인 메모리 파일은 무시되며 마이그레이션되지 않습니다. Agent는 단어 선택보다는 의도에 따라 저장합니다. 현재 작업 이후에도 적용되기를 바라는 작동 규칙이나 선호 사항을 진술하면, '기억해 줘'를 기다리지 않고 자동으로 저장하고 무엇을 저장했는지 알려줍니다. 작업 방식에 대한 규칙은 Procedure Memory로, 커뮤니케이션 또는 발표 선호 사항은 User Profile로 이동합니다. 이미 저장된 내용이 있는 경우, MemoraX Code는 쓰기 전에 의미를 비교합니다. 동등한 요청은 변경하지 않으며, 지속적인 개선이나 충돌이 발생하면 일치하는 항목을 업데이트하고 대체된 문구를 제거합니다. 유효 범위를 벗어난 내용은 수정되거나, 해당 항목이 완전히 구식이 되었을 때만 삭제됩니다. 명시적인 잊기(forget) 요청은 이름이 지정된 선호 사항, 절차 주제, 섹션 또는 단계만 삭제하며 관련 없는 메모리는 변경하지 않습니다. 일회성 작업 지침은 저장된 메모리를 변경하지 않으며, 지속적인 의도나 목표가 불분명할 때는 Agent가 쓰기 전에 사용자에게 문의합니다.

Trae는 Skill 전용으로 유지되며, Cursor는 자체 백그라운드 서브에이전트를 사용합니다. | 활성 메모리 제어 | 번들된 MemoraX Code 스킬 또는 CLI를 통해 메모리를 검색하고 추가할 수 있습니다. | 클라이언트 통합 | Codex, Claude Code, CodeBuddy CLI, WorkBuddy, DeepSeek Harness, OpenCode, Trae, 그리고 Cursor와 통합되어 Skill 기반 검색, 로컬 알림, 자동 쓰기백(writeback)을 지원합니다. 자동 할당량 알림은 현재 Codex, Claude Code, CodeBuddy CLI, WorkBuddy, OpenCode, 그리고 Trae에서 이용 가능합니다. | 로컬 관측성 | 활동 횟수, 검색 및 쓰기백 상태를 검사하기 위해 콘텐츠 제어형 로컬 추적(trace) 및 조정 기록을 사용합니다.

MemoraX는 클라우드 기반 메모리에 필요합니다. 설정을 완료하면 MemoraX 검색/추가 기능과 생성된 구성의 자동 쓰기백이 활성화되며, 두 번째 쓰기백 확인 절차는 없습니다. 검색은 에이전트가 스킬을 사용하거나 CLI를 호출할 때 실행됩니다. 훅(Hooks)은 검색 요청을 발생시키지 않고 로컬 메모리 컨텍스트와 알림을 제공합니다.

선택적 Jev 구성은 별도의 TypeSafe 모델이 각 적격한 고유 사용자 요청을 판단하도록 합니다. 검색이 유용할 때, 에이전트는 memorax-code를 읽습니다.