supermemoryai/opencode-supermemory

opencode‑supermemory

무엇인가요 – OpenCode AI 코딩 어시스턴트용 플러그인으로, 세션과 프로젝트 간에 지속적이고 검색 가능한 메모리를 제공합니다. 사용자 선호사항, 프로젝트 아키텍처, 오류-해결 패턴, 대화 스니펫과 같은 "메모리"를 저장하고 검색하기 위해 Supermemory 서비스(https://supermemory.ai)와 통신합니다.

주요 기능

• 자동 캡처 – 설정 가능한 주기(몇 번의 대화 후)마다 대화가 Supermemory에 저장되며, 세션 종료 시 남은 대화는 플러시됩니다.
• 컨텍스트 삽입 – 세션의 첫 번째 메시지에서 에이전트는 간결한 프로필, 프로젝트 메모리 목록, (옵션으로) 개인 메모리에 대한 의미적 검색 결과를 받습니다. 사용자가 명시적으로 요청할 필요 없이 자동으로 제공됩니다.
• 논리적 복기 – 응답하기 전에 메모리 검색이 도움이 되는지 판단합니다. 도움이 된다고 판단되면 supermemory 도구를 실행하고 결과는 자동 승인되어 모델 요청에 삽입됩니다(설정 가능한 최대 일치 수까지).
• 키워드 유도 – "remember", "save this" 등의 표현(또는 사용자 정의 정규식)을 말하면 즉시 저장이 강제됩니다.
• 코드베이스 인덱싱 – /supermemory-index (또는 /supermemory-init) 명령어를 통해 에이전트가 리포지토리를 탐색하고 구조적 및 패턴 정보를 저장합니다.
• 압축 메모리 – OpenCode의 컨텍스트 창이 임계값에 도달하면, 플러그인은 관련 메모리를 요약 단계에 풍부하게 제공하고 요약 결과를 새로운 메모리로 저장합니다.
• 프라이버시 – <private>…</private>로 감싸인 내용은 저장 전에 제거됩니다.
• 상태 알림 – 작은 비침습적 토스트(또는 TUI 메시지)로 메모리 저장, 복기, 또는 최신 플러그인 버전 사용 가능 여부를 사용자에게 알립니다.

설치 및 설정

bunx opencode-supermemory@latest install   # OpenCode V1 및 V2 모두에 플러그인 등록
bunx opencode-supermemory@latest login      # 또는 config 파일에 SUPERMEMORY_API_KEY 설정
bunx opencode-supermemory@latest status     # 연결성 확인

설치 프로그램은 두 세대 모두에 적절한 항목을 ~/.config/opencode/opencode.jsonc에 기록하고 /supermemory-index 명령어를 생성합니다. 채팅 내 명령어(/supermemory-init, /supermemory-login 등)도 제공됩니다.

사용 방법

• 에이전트는 자동으로 메모리 컨텍스트를 받습니다. 직접 도구를 호출할 수도 있습니다:

  {"mode": "search", "query": "how to build with bun"}
  

• /supermemory-index를 실행하여 에이전트가 리포지토리를 스캔하고 메모리를 채웁니다.
• 키워드 표현을 사용하거나, 설정 파일의 keywordPatterns에 사용자 정의 정규식을 추가하여 수동 저장을 트리거합니다.

설정 (모두 선택 사항, ~/.config/opencode/supermemory.jsonc 또는 환경 변수로 저장)

설정	의미
SUPERMEMORY_API_KEY	Supermemory 서비스용 API 키
captureEveryNTurns	자동 저장 간의 대화 횟수 (기본값 3)
recallMode	direct (각 프롬프트에서 자동 검색), advisory (에이전트가 결정), off
maxMemories	각 요청에 삽입되는 최대 메모리 수
keywordPatterns	일치 시 저장을 트리거하는 추가 정규식
compactionThreshold / compactionEnabled	요약을 트리거할 임계값 및 OpenCode 2의 내장 압축 강화 여부
SUPERMEMORY_DEBUG=1	디버깅용 내부 복기 결정 로그 표시

지원되는 범위 및 유형

• 범위: user (개인) 또는 project (기본값). 태그는 Git 원격 또는 파일 시스템 경로에서 유도되며, Claude Code, Codex, Cursor 등과 동일한 컨테이너를 사용합니다.
• 유형에는 project-config, architecture, error-solution, preference, learned-pattern, conversation 등이 포함됩니다.

라이선스 – MIT.

---

모든 세부 정보는 리포지토리의 README에서 직접 가져왔습니다.