Memory Ferry

Memory Ferry · 记忆摆渡는 AI 에이전트를 위한 로컬 우선 방식의 기기 간 장기 메모리 및 재사용 가능한 Skill 계층입니다. 일반 Vault 폴더를 iCloud Drive, OneDrive, Dropbox, Syncthing 또는 마운트된 NAS에 넣은 다음, Codex, Claude Code, Cursor, OpenCode, DeepSeek Harness, Gemini CLI, GitHub Copilot CLI, MiniMax Code를 동일한 메모리에 연결하세요.

中文说明 · 영문 사용 가이드 · 中文使用手册

0.6.0-beta.1 버전은 종단 간 암호화를 제공하지 않습니다. 비밀번호, API 키, 토큰, 개인 키, 복구 코드 또는 기타 비밀 정보를 절대 저장하지 마세요.

존재 이유

• 컴퓨터 간: 호스팅된 컨트롤 플레인이나 데이터베이스 데몬 없이 일반 파일을 동기화합니다.

• 에이전트 간: 메모리를 특정 모델 공급업체에 종속시키는 대신 단일 MCP 및 CLI 계약을 제공합니다.

• 오프라인 친화적: 각 쓰기는 독립적인 불변 JSON 이벤트이며 나중에 동기화됩니다.

• 충돌 허용: 동시 추가가 서로를 덮어쓰지 않으며 업데이트는 결정적으로 수렴합니다.

• 재사용 가능한 Skill: macOS와 Windows에서 콘텐츠 해시를 기준으로 단일 Vault 소스를 에이전트별 Skill 디렉터리에 복사합니다.

• 저비용: 이미 운영 중인 스토리지와 동기화 소프트웨어를 재사용합니다.

Related MCP server: SharedBrain

지원되는 에이전트

빠른 시작

Node.js 20 이상이 필요합니다:

npm install -g memory-ferry@beta

memory-ferry init "/path/to/your/synced/MemoryFerryVault"
memory-ferry agents install all
memory-ferry remember "Prefer concise answers" --kind preference --scope global
memory-ferry recall "answer style"
memory-ferry ui

베타 기간에는 명시적 @beta 태그를 사용하세요. 업그레이드 또는 제거는 다음과 같이 합니다:

npm install -g memory-ferry@beta
npm uninstall -g memory-ferry

대시보드는 루프백 전용이며, 브라우저에서 열리고, 영어와 중국어를 지원하며, 여러 Vault를 관리하고, 에이전트를 연결하거나 연결 해제하며, Vault 콘텐츠를 안전하게 마이그레이션하고, 실행 중 5분마다 Skill을 조정합니다.

Windows 휴대용 앱

Windows x64 릴리스는 휴대용 MemoryFerry.exe입니다. 설치 프로그램이나 별도의 Node.js 설치는 필요하지 않습니다. EXE를 영구 폴더에 넣고 더블클릭하세요. 콘솔 창 없이 시작되어 로컬 대시보드를 엽니다. 명령줄 출력이 필요할 때는 번들된 MemoryFerry-CLI.cmd를 사용하세요.

베타 버전은 상업용 코드 서명이 되어 있지 않으므로 Windows에서 알 수 없는 게시자 경고가 표시될 수 있습니다. 포함된 SHA-256 파일을 확인하고 SmartScreen을 계속 사용하도록 설정하세요.

저장 모델

MemoryFerryVault/
├── memory-ferry.json
├── memory/events/<device-id>/<date>/<event-id>.json
└── skills/<skill-name>/...

기기 식별자, 시계, 이벤트 캐시, 그리고 선택적 Ollama 임베딩 인덱스는 동기화 폴더 외부에 유지됩니다. Vault에는 활성 SQLite 데이터베이스, WAL 또는 잠금 파일이 포함되지 않습니다.

업그레이드 호환성

Memory Ferry는 기존 Agent Vault Sync 설치를 인식합니다:

• agent-vault.json이 허용되며, 기존 파일을 삭제하지 않고 새 memory-ferry.json 동반 매니페스트가 생성됩니다.

• ~/.agent-vault-sync 상태는 새 상태가 존재하지 않을 때 ~/.memory-ferry로 마이그레이션됩니다.

• AGENT_VAULT_* 환경 변수는 이에 대응하는 MEMORY_FERRY_* 변수의 폴백으로 유지됩니다.

• 에이전트를 다시 연결하면 기존 관리형 agent-vault 항목이 제거되고 memory-ferry가 기록됩니다.

• 레거시 agent-vault CLI 별칭은 베타 마이그레이션 기간 동안 계속 사용할 수 있습니다.

업그레이드 전에 중요한 Vault를 백업하고, 다른 컴퓨터에서 같은 Vault를 열기 전에 동기화 클라이언트가 완료될 때까지 기다리세요.

선택적 의미 기반 검색

로컬 Ollama를 사용할 수 있으면 recall과 context는 의미적 유사도와 Unicode/CJK 텍스트 점수를 혼합합니다. 텍스트 전용 검색을 사용하려면 MEMORY_FERRY_EMBED=off를 설정하거나 --no-semantic을 전달하세요. 임베딩 인덱스는 로컬에 유지되며, 클라우드 동기화 또는 마이그레이션 후 첫 번째 쿼리가 반환되기 전에 복구됩니다.

개발

npm ci
npm run test:all
npm audit --omit=dev
npm pack --dry-run

Windows 릴리스는 GitHub Actions에서 빌드되어 스모크 테스트를 거칩니다. CONTRIBUTING.md, SECURITY.md, architecture.md를 참조하세요.

라이선스

MIT. 독립 실행형 릴리스에는 Node.js 및 타사 라이선스 고지도 포함됩니다.