crewmemory

팀의 모든 AI 코딩 에이전트를 위한 하나의 공유 메모리 — Claude Code, Codex, Cursor, Gemini CLI, opencode, Windsurf, Claude Desktop 또는 모든 MCP 클라이언트.

메모리는 여러분이 소유한 git 리포지토리(GitHub 또는 모든 git 호스트)에 저장됩니다. 저장할 때마다 자동으로 커밋되고 푸시되며, 읽을 때마다 먼저 최신 상태를 가져옵니다. 팀원의 에이전트가 수정 사항, 결정, 또는 작업 중인 내용을 기록하면 — 몇 초 후에 여러분의 에이전트도 알게 됩니다.

실행할 서버가 없습니다. 클라우드 데이터베이스도 없습니다. 락인도 없습니다: 그냥 일반 markdown + git입니다.

설치

단일 명령 (패키지 게시 후)

uvx --from crewmemory-mcp crewmemory install codex --repo https://github.com/org/crewmemory.git --user alice --launcher uvx

codex를 claude-code, claude-desktop, cursor, gemini, opencode, 또는 windsurf로 바꾸세요. uv가 설치되어 있으면 동일한 명령이 Windows, macOS, Linux에서 작동합니다. 등록 후 클라이언트를 다시 시작하세요.

비공개 메모리 리포지토리라면 --token <fine-grained-token>도 전달하세요. 해당 리포지토리에만 권한이 있고 Contents 읽기/쓰기 권한이 있는 토큰을 사용하세요.

소스 체크아웃에서 설치

uv venv .venv
uv pip install --python .venv/bin/python -e .
.venv/bin/crewmemory install codex --repo https://github.com/org/crewmemory.git --user alice

Windows에서 실행 파일은 .venv\Scripts\crewmemory.exe입니다.

지원 클라이언트: claude-code, claude-desktop, codex, cursor, gemini, opencode, windsurf. 설치 프로그램은 기존 설정을 백업하고 병합하며, 멱등적이고, 에이전트 외부에서도 crewmemory doctor 및 crewmemory ui가 작동하도록 개인 로컬 연결 프로필을 저장합니다.

또는 AI에게 그냥 요청하기

이 폴더에서 실행 중인 에이전트에 다음을 붙여넣으세요:

Install yourself as a crewmemory MCP server for Claude Code. My memory repo is https://github.com/org/crewmemory.git, my name is alice, token is github_pat_xxx.

에이전트가 crewmemory install claude-code ...를 대신 실행합니다. 수동으로 도구를 호출할 필요가 없습니다.

프로젝트 감지

세션 시작 시 MCP 지침은 에이전트에게 team_context(project_path="<absolute workspace root>")를 호출하도록 안내합니다. 이렇게 하면 현재 Git 리포지토리와 브랜치를 동적으로 선택하므로 하나의 전역 MCP 설치가 여러 프로젝트에 걸쳐 작동합니다. crewmemory init은 선택 사항이며 인간과 진단을 위해 로컬 레지스트리에 프로젝트를 기록합니다.

crewmemory init            # registers the project; reads branch/git identity

언제든 검증

crewmemory doctor          # config, connectivity, project detection, counts

Related MCP server: bikky

인간용 대시보드 (에이전트 불필요)

crewmemory ui              # opens http://127.0.0.1:8765 in your browser
crewmemory ui --port 9000 --no-browser

팀 전제를 위한 로컬 웹 대시보드입니다 — 에이전트에게 묻지 않고 모든 것을 확읹하세요:

• 지금 팀 — 지금 누가 무엇을 하고 있는지, 진헹률 표시줄, ⛔ 차단 항목, 오래된 배지

• 활동 — 전체 타임라인: 모든 구성원의 모든 메모/결정/해결책/상태/삭제 기록

• 메모리 — 여섯 가지 유형 모두 탐색 및 검색, 작성자/종류로 필터링, 전체 텍스트 펼치기

• 프로필 — 구성원 역할, 시간대, git 신원

• 개요 — 유형/작성자/프로젝트/수명주기별 개수 + 저장소 정보

읽기 전용이며 127.0.0.1에만 바인딩되고 30초마다 자동 새로고침됩니다. 추가 의존성이 전혀 없습니다.

Windows

완전 지원됩니다:

uv venv .venv-win
uv pip install --python .\.venv-win\Scripts\python.exe -e .
.\.venv-win\Scripts\crewmemory.exe install claude-code --repo ... --user alice --token ...
.\.venv-win\Scripts\crewmemory.exe ui

구성원 이름은 모든 플랫폼에서 안전한 파일 이름으로 정리되며(_member_filename), Codex TOML 값은 Windows 경로/백슬래시/따옴표에 맞게 올바르게 이스케이프되고, 모든 git 호출은 GIT_TERMINAL_PROMPT=0으로 실행되어 입력을 기다리며 멈추는 일이 없습니다.

에이전트가 할 수 있는 작업 (도구)

기능 체크리스트

• 공유 크루 메모리 (자체 git 호스트에) · 개인 비공개 메모리 (로컬 전용 범위, 푸시되지 않음)

• Git 네이티브 저장소: markdown + YAML frontmatter, 충돌 없는 파일 전략 (고유 파일 이름, 사용자별 상태/활동 파일)

• 모든 읽기/쓰기 시 자동 세션 동기화 · 수동 동기화 도구 · 오프라인 안전 (쓰기는 로컬에서 커밋, 푸시는 나중에 재시도)

• 사용자 및 구성원 프로필, git config에서 자동 생성 (crewmemory init)

• 팀 상태의 진행률 추적 및 차단 항목 추적, 오래됨 표시 포함

• 결정 메모리, 주의사항, 패턴, 해결책, 인계 — 여섯 가지 항목 유형

• 메모리 수명주기: 미검증 → 검증됨 → 대체/오래됨, 신뢰도 점수는 시간이 지나고 연결된 코드가 변경될 때 낮아짐 (코드 변경 인지 감쇠)

• 저장 시 충돌/중복 감지 + 통합 탐색기

• 출처: 작성자 표시, 커밋 연결 메모리, 메모리별 전체 git log --follow 기록

• 시간 이동: 모든 커밋/태그/브랜치에서 크루 메모리 읽기

• 브랜치 인지 컨텍스트: 항목이 프로젝트+브랜치를 기억, recall은 현재 브랜치 일치를 가중

• 컨텍스트 예산 관리: recall이 최상의 메모리를 문자 예산에 맞게 패킹

• 코드 통합: 파일 연결 메모리가 PR-대-결정 검토, PR 후 오래된 메모리 감지, 이 코드가 왜 존재하는지 조회, blame 상호 참조, 커밋 요약을 지원

• 프로젝트별 메모리: 항목은 감지된 프로젝트 슬러그로 태그 지정, 상태는 project@branch 표시

• 패싯 검색: 태그, 작성자, 파일, 유형, 프로젝트 (의미 검색: 향후 작업)

• MCP 기반, stdio 전송, 기본적으로 자체 호스팅/오픈소스

리포지토리 구조 (자동 생성)

notes/ decisions/ solutions/ gotchas/ patterns/ handoffs/   # memory types
status/     current focus per member (task, %, blockers)
activity/   append-only timeline per member
profiles/   member profiles

설정 (팀원별)

수동 설정 스니펫(직접 설정을 편집하려는 경우)은 설치 프로그램에 들어 있습니다 — 정확히 이 형태로 작성합니다:

{ "mcpServers": { "crewmemory": {
    "command": "/path/to/crewmemory",
    "env": { "CREWMEMORY_REPO_URL": "...", "CREWMEMORY_USER": "...", "CREWMEMORY_TOKEN": "..." }
} } }

Codex는 ~/.codex/config.toml에서 [mcp_servers.crewmemory] 형식을 사용하고, OpenCode는 mcp.servers.*.type=local 형식을 사용합니다 — 둘 다 crewmemory install codex/opencode로 처리됩니다.

권장 팀 워크플로

CLAUDE.md / AGENTS.md에 추가하세요:

At session start call team_context(project_path="<absolute workspace root>"), then update_status() for your task.
Use recall() before researching anything the team may know.
Save durable learnings immediately (log_solution/log_decision/save_gotcha/save_pattern).
When switching tasks update update_status(); at day's end call save_handoff().

또는 내장 프롬프트를 사용하세요: /session-start, /session-end, /pr-review-flow.

보안

• 비밀을 메모리에 저장하지 마세요 — 읽을 수 있는 git 리포지토리입니다.

• 공개 메모리 리포지토리는 모든 팀 메모, 상태, 경로, 인계를 공개합니다. 비공개를 선호하세요.

• 비공개 리포지토리 + 세분화된 PAT(구성원당 하나, Contents: RW)가 의도된 설정입니다.

• 토큰은 로컬 환경/설정에만 유지되며, 모든 git 출력은 에이전트에게 도달하기 전에 편집됩니다.

배포

이 리포지토리에는 크로스 플랫폼 CI, wheel/sdist 검사, PyPI 신 게시 워크플로우가 포함되어 있습니다. 릴리스 체크리스트는 PUBLISHING.md를 참조하세요.

문제 해결

• crewmemory doctor가 모든 것을 진단하고 정확한 해결책을 출력합니다.

• 인증 실패 → 토큰에 메모리 리포지토리에 대한 Contents 읽기+쓰기 권한이 필욯합니다.

• 재시도 후에도 시 실패 → 변경 사항은 로컬에서 안전합니다(대기 중). 나중에 sync_memory를 실헹하세요.

• "Points to a different remote" → ~/.crewmemory/<repo>를 삭제하거나 CREWMEMORY_LOCAL_PATH를 설정하세요.