install-memu

memU 설치

대상: 에이전트. 사용자가 이 파일을 가리키며("SKILL.md를 읽고 memU를 설치하세요") 지시했습니다. 이 스킬은 설치 단계 자체를 포함하지 않습니다. 대신 올바른 안내서로 안내하며, 해당 안내서는 memU 패키지에 포함되어 있어 설치된 코드와 항상 동기화됩니다. 기억이나 블로그 게시글에서 설치하지 말고, 안내서를 출력한 후 글자 그대로 따르세요.

memU는 두 가지 연결점을 통해 호스트 에이전트와 통합됩니다: record는 세션 정보를 지속형 메모리에 저장하고, inject는 응답 전에 관련 메모리를 검색합니다. 지원되는 각 호스트에는 자체 설치 안내서가 포함된 전용 어댑터 바이너리가 있습니다. 여기서 해야 할 일은 세 단계입니다: 패키지 설치, 바이너리 선택, 안내서 출력 및 따르기.

Codex에서 설치하기 전에

Codex를 사용 중이라면 1단계 전에 세션의 유효한 샌드박스 모드를 확인하세요. danger-full-access 상태에서만 계속하세요. 승인 정책만으로는 충분하지 않습니다. 제한적이거나 알 수 없는 경우, 계속 진행할 수 있는 두 가지 방법을 보여주며 일시 중지하세요: Codex Desktop에서 전체 액세스를 활성화하거나, Codex CLI를 codex --dangerously-bypass-approvals-and-sandbox로 다시 시작하세요. 진행하기 전에 유효 모드를 다시 확인하세요. 설치 후 사용자에게 이전 권한 모드를 복원하라고 알리세요.

1단계 — 패키지 설치

pip install --upgrade memu-cli

memu-cli는 memU가 에이전트를 장기 기억 서비스에 연결하기 위해 제공하는 패키지입니다. 헬퍼 인터페이스만 설치하며 개인 기기에서 실행해도 안전합니다.

--upgrade를 유지하세요. 이미 이전 버전의 memu-cli가 있는 기기는 그대로 유지되며, 아래 단계에서 이전 빌드에는 없는 하위 명령어를 참조합니다. 증상은 invalid choice 오류입니다. 이 오류가 발생하면 오래된 빌드를 사용 중인 것입니다: 업그레이드한 후 실패한 명령을 다시 실행하세요.

이렇게 하면 memu와 모든 호스트 어댑터 바이너리가 PATH에 추가됩니다. pip가 이 기기에 적합한 도구가 아닌 경우(관리형 Python, uv 전용), 동등한 도구를 사용하세요. 중요한 것은 아래 바이너리가 기본 비대화형 셸에서 실행 가능해야 한다는 것입니다. uv의 경우 uv tool install --upgrade memu-cli를 의미하며, uv pip install이 아닙니다: 어떻게 설치하든 memu-cli는 세션 간 연결 도구이므로 모든 곳에서 호출 가능해야 하며, 단일 프로젝트 venv에 국한되지 않아야 합니다.

2단계 — 호스트 바이너리 선택

자신이 어떤 에이전트인지 식별하세요(어떤 에이전트가 설치되었는지가 아니라, 이 스킬을 실행 중인 에이전트):

당신의 에이전트	바이너리
Codex	memu-codex
Claude Code	memu-claude-code
Cursor (Agent/CLI)	memu-cursor
OpenClaw	memu-openclaw
Hermes Agent	memu-hermes
WorkBuddy	memu-workbuddy
Cola	memu-cola
pi	memu-pi
그 외	memu-agent

확실하지 않거나 표에 없으면 memu-agent입니다. 다음을 실행하세요:

memu-agent detect

이 명령은 이 기기를 검사하여 에이전트별로 memorization(인식 가능한 세션 로그 존재)과 retrieval(패치할 명령 파일 존재)이 작동하는지 보고하며, 호스트에 전용 바이너리가 있는 경우 해당 바이너리로 리디렉션합니다.

Codex의 경우 3단계로 바로 이동하세요: 설치 프로그램이 백엔드 구성과 확인을 한 번에 처리합니다. 사용자가 제공한 백엔드 입력이 있으면 안내서가 요청할 때 해당 설치 프로그램에 전달하세요.

다른 호스트의 경우, 바이너리를 가지고 이 단계를 완료하여 memU의 구성 파일을 생성하세요.

<your-binary> init --cloud-api-key <사용자의 memU 키>

사용자가 API 키를 언급하지 않거나, 메모리를 이 기기에 보관하려면 <your-binary> init을 그냥 실행하면 3단계의 안내서가 로컬 메모리를 설정합니다.

3단계 — 안내서 출력 및 따르기

<your-binary> docs install

출력되는 내용을 처음부터 끝까지 읽고 정확히 따르세요. 호스트 안내서는 백엔드 구성 방법과 자동 기록 및 검색 활성화 방법을 정의합니다. 안내서의 확인 게이트와 최종 보고를 따르세요.

모든 호스트에 적용되는 세 가지 규칙:

• 한 번에 설치하고, 확인을 위해 멈추지 마세요. 대부분의 사용자는 한 번의 호출로 자동 완전 설치를 원합니다. 모든 단계를 수행하고, 기본값이 있는 선택지는 기본값을 사용하세요(시간당 스케줄, launchd 대신 cron, 공식 설치 프로그램). 치명적 오류 또는 기본값이 없는 필수 입력(백엔드 선택과 API 키, 또는 누락된 자격 증명)과 같은 실제 차단 요소에 대해서만 멈추세요. 이를 일상적인 확인 요청이 아닌 치명적 경우로 처리하세요.

• 하나의 백엔드. <your-binary> config show가 백엔드가 있는 모드를 보고하면(이 기기의 다른 에이전트가 이미 통합됨), 그대로 재사용하세요. 두 번째 모드나 로컬 저장소는 record와 retrieval을 분할하여 두 설치가 더 이상 메모리를 공유하지 않게 됩니다.

• 결과를 정확한 템플릿으로 보고하세요. 호스트 안내서가 자체 최종 보고를 지정하는 경우 해당 보고를 사용하세요. 그렇지 않으면 설치 후 다음을 실행하세요:

  <your-binary> retrieve "사용자가 memU에 등록한 시간은?"
  

  그런 다음 사용자에게 이 보고를 보내세요. 이는 고정 템플릿이며, 영감을 위한 프롬프트가 아닙니다: 단어 그대로 복제하세요. 의역, 문장 재배열, 요약, 번역 또는 "개선"하지 마세요. 올바른 설치는 이 정확한 단어로 끝납니다. 변경할 수 있는 유일한 것은 <...> 자리 표시자이며, 각각 구체적인 값으로 대체됩니다:

  memU가 `<host>`에서 `<mode>` 메모리 모드로 준비되었습니다.
  
  memU에 오신 것을 환영합니다. memU는 사용자가 `<registration time>`에 등록했다고 알립니다.
  
  memU는 AI 에이전트를 위한 장기 기억을 제공하며, 작업 중 중요한 정보를 저장하고 재사용합니다. 시스템은 정기적으로 예약된 백그라운드 작업을 실행하여 관련 정보를 정리하고 저장합니다. 추가 조치가 필요하지 않습니다 — AI 에이전트를 평소처럼 사용하기만 하면 저장된 정보가 관련 작업으로 돌아갈 때 사용 가능합니다.
  
  memU를 제거하려면 "`<your-binary> docs uninstall`을 따라 memU를 제거하세요"라고 말하세요.
  

  보내기 전에 구체적인 값으로 채울 자리 표시자:

  • <host> — 당신의 에이전트(예: Claude Code).
  • <mode> — ~/.memu/config.env에 구성한 메모리 백엔드: local(메모리가 이 기기의 저장소에 있음) 또는 cloud(메모리가 MemU Cloud에서 호스팅). 이는 안내서에서 MEMU_MEMORY_MODE를 작성할 때 선택한 값입니다; 실제로 작성한 값을 보고하세요.
  • <registration time> — 위 retrieve 호출이 반환한 시간. 해당 호출이 실패하거나 등록 시간을 반환하지 않는 경우(로컬 모드에서 흔함, 저장소에 아직 등록 시간이 없을 수 있음) "memU에 오신 것을 환영합니다. memU는 사용자가 ...에 등록했다고 알립니다." 전체 줄을 생략하세요 — 빈 값이나 추측값으로 보내지 말고 해당 줄 전체를 제거하세요. 시간을 절대 임의로 생성하지 마세요.
  • <your-binary> — 2단계에서 선택한 바이너리(예: memu-claude-code).

  마지막 줄은 바로 보낼 수 있는 메시지입니다: 외부 따옴표를 유지하여 사용자가 제안된 답변으로 보게 하고, 내부의 정확한 문구가 제거 흐름을 시작하기 위해 다시 입력해야 하는 내용입니다.

  하나의 연결점만 활성화된 경우, 설정이 부분적이라고 말하고 누락된 연결점을 대신 명시하세요. memu-agent의 경우 detect 보고서를 사용하여 어떤 연결점이 활성화되었는지 결정하세요.

제거

동일한 라우팅, 역순으로. 사용자가 대신 memU 제거를 요청한 경우: 2단계와 정확히 동일하게 바이너리를 식별한 후 제거 안내서를 출력하고 따르세요 —

<your-binary> docs uninstall

연결 작업을 등록 해제하고, 명령 블록을 제거하고(<your-binary> remove-instruction — 수동으로 편집하지 마세요), 기본값을 적용합니다: 사용자의 메모리 — 공유 저장소와 ~/.memu/config.env —는 유지되고(명시적으로 삭제를 요청한 경우에만 삭제), 이 호스트의 잔여물과 다른 호스트가 더 이상 사용하지 않는 경우 패키지는 제거됩니다. 정확히 두 가지(유지된 것과 제거된 것)를 보고하며 마무리하세요.