AI 코딩 에이전트 간에 바통을 넘기세요 — 흐름을 잃지 않고 말이죠.
메모리 도구는 모든 것을 저장합니다. Passoff는 중요한 순간을 표시합니다. Claude Code, Cursor, Codex, Windsurf 및 모든 MCP 클라이언트 간에 컨텍스트를 넘기는 단 하나의 명령어로, 어떤 AI가 누구에게 무엇을 보냈는지에 대한 완전한 출처를 제공합니다.
로컬 우선. ~/.passoff/db.sqlite에 SQLite 저장. 클라우드, 계정, API 키, 텔레메트리 없음.
내장된 출처. 모든 핸드오프는 from_client, from_model, to_client, 타임스탬프를 기록합니다. MCP 프로토콜은 클라이언트 이름을 스탬프 처리하므로 AI는 어떤 도구가 작성했는지 거짓말을 할 수 없습니다.
내장된 계보. 핸드오프는 부모를 참조하여 여러 AI와 세션에 걸쳐 추적 가능한 체인을 형성합니다.
단 하나의 작업. 핸드오프. 메모리, 오케스트레이션, 대시보드가 아닙니다.
Related MCP server: meridian
Claude Code에서 기능을 완료할 때:
사용자:
/passoff — UI 작업을 위해 Cursor로 전환Claude가 구조화된 마크다운 핸드오프를 작성하고
{ id: "ph_aB3x9K" }를 반환합니다.
Cursor를 열고 새 채팅을 시작하세요:
사용자:
/passoff-loadCursor가
passoff_load({ latest: true })를 호출하여 마크다운을 가져오고, 생각하던 중간부터 다시 시작합니다.
나중에 체인을 추적하세요:
$ passoff thread ph_GuqtDKDO
o ph_Mo12sReh Refactor auth middleware
| claude-code -> cursor [loaded]
|
* ph_GuqtDKDO Wired auth into login
| cursor -> codex [loaded]
|
o ph_T0s2ZQvD Fixed login tests
codex [open]npm i -g passoff**Node 20+**가 필요합니다.
또는 소스에서 실행:
git clone https://github.com/TheMrGU/passoff && cd passoff
npm install && npm run build
node dist/index.js --help리포지토리가 로컬에 체크아웃된 경우, 이 명령어로 모든 지원되는 클라이언트에 Passoff를 한 번에 연결합니다:
npm run setup이 명령어는 npm install + npm run build를 실행하고, Claude Code에 MCP 서버를 등록하며(설치된 경우 claude mcp add를 통해), ~/.cursor/mcp.json, ~/.codeium/windsurf/mcp_config.json, ~/.codex/config.toml을 작성/병합하고, 슬래시 명령 템플릿을 설치합니다. 그 후 각 AI 클라이언트를 다시 시작하세요.
claude mcp add passoff -- npx -y passoff serve~/.cursor/mcp.json (또는 프로젝트 내 .cursor/mcp.json){
"mcpServers": {
"passoff": { "command": "npx", "args": ["-y", "passoff", "serve"] }
}
}~/.codex/config.toml[mcp_servers.passoff]
command = "npx"
args = ["-y", "passoff", "serve"]Codex 네이티브 슬래시 명령 설치:
passoff install --client codex이 명령어는 /passoff:create, /passoff:load, /passoff:list, /passoff:search를 로컬 Codex 플러그인으로 등록합니다.
동일한 stdio 명령 쌍 사용 — docs/clients.md 참조.
passoff install 후, 모든 지원되는 클라이언트는 동일한 4개의 명령어를 가집니다(Codex는 /passoff:create 등을 사용하며, Claude Code와 Cursor는 /passoff, /passoff-load, /passoff-list, /passoff-search를 사용합니다).
명령어 | 기능 |
| 나가는 AI가 구조화된 핸드오프를 작성하고 ID를 반환 |
| 들어오는 AI가 가장 최근의 활성 핸드오프(또는 ID별 핸드오프)를 로드 |
| 현재 프로젝트의 최근 핸드오프 탐색 |
| 핸드오프 전체 텍스트 검색 |
도구 | 목적 |
| 나가는 AI가 구조화된 핸드오프 작성 |
| 들어오는 AI가 |
| 프로젝트 내 핸드오프 탐색 (메타데이터만) |
| 핸드오프 전체 텍스트 검색 (FTS5) |
| 핸드오프의 계보 체인 표시 |
passoff serve # run MCP server (stdio) — invoked by clients
passoff list [--project X] # recent handoffs table
passoff show <id> # full markdown + metadata
passoff thread <id> # lineage tree
passoff archive <id> # mark archived
passoff delete <id> # hard delete (confirms)
passoff clear [--project X] # archive all open in a project (confirms)
passoff doctor # DB path, version, row counts, MCP config hints
passoff install # install Claude/Cursor/Codex command templates
passoff uninstall # remove installed command templatesDB 위치: ~/.passoff/db.sqlite (PASSOFF_DB_PATH로 재정의 가능).
프로젝트 범위: PASSOFF_PROJECT_ROOT에서 파생되며, 없으면 가장 가까운 .git 디렉토리, 그마저도 없으면 cwd를 사용합니다. 슬러그는 <dir>-<6char hash> 형식이므로 두 개의 api/ 디렉토리가 충돌하지 않습니다.
텔레메트리 없음. 네트워크 호출 없음. SQLite 브라우저에서 DB를 열어보세요.
둘 다 각자의 위치가 있으며, 서로 다른 문제를 해결합니다.
Passoff | 공유 메모리 도구 | |
기본 단위 | 개별적이고 의도적인 핸드오프 이벤트 | 항상 켜져 있는 메모리 풀 |
트리거 | 사용자가 | 암시적, 모든 프롬프트마다 |
다음 AI가 보는 것 | 이전 AI가 전달하기로 선택한 정확한 내용 | 검색 결과에 나타난 모든 것 |
출처 | 행에 내장됨 (클라이언트, 모델, 부모) | 추가된 메타데이터 |
정리 | 핸드오프 원자 단위 보관 또는 삭제 | 임베딩 추적 |
최적 용도 | 생각 도중 도구 전환; 결정 추적 | "6주 전에 우리가 무엇을 했지?" 회상 |
메모리 도구는 *"무엇이 관련이 있을까?"*에 답합니다. Passoff는 *"다음에 무엇을 로드해야 할지 정확히 알려줍니다."*에 답합니다.
전체 포지셔닝: docs/design.md.
데이터는 어디에 저장되나요?
~/.passoff/db.sqlite에 있는 단일 SQLite 파일입니다. 모든 SQLite 브라우저로 열 수 있습니다. 클라우드 구성 요소는 없습니다.
Passoff가 네트워크를 통해 무언가를 보내나요? 아니요. MCP 서버는 stdio 전용입니다. CLI는 외부로 데이터를 보내지 않습니다. 설정 스크립트는 로컬 구성 파일만 작성합니다.
두 프로젝트가 동일한 DB를 공유할 수 있나요? 네 — 모든 핸드오프는 프로젝트 슬러그로 범위가 지정됩니다. DB는 전역적이지만, 뷰는 기본적으로 프로젝트별로 나뉩니다.
두 AI가 동일한 핸드오프에서 충돌할 수 있나요?
아니요. 로드하면 상태가 open → loaded로 바뀌고 to_client가 스탬프 처리되지만, 보관하기 전까지는 세션 간에 행을 다시 로드할 수 있습니다.
[다른 MCP 클라이언트]와 함께 사용할 수 있나요? 클라이언트가 stdio를 통해 MCP를 지원한다면 가능합니다. 동일한 방식으로 연결하세요. docs/clients.md를 참조하세요.
그냥 대화 내용을 붙여넣으면 안 되나요?
세 가지 이유가 있습니다: (1) 수신 AI는 노이즈가 아닌 사용자가 전달하기로 선택한 정확한 내용을 받습니다; (2) 행은 감사 가능합니다 — from_client, from_model, 타임스탬프; (3) 계보는 다단계 워크플로우에 걸쳐 연결됩니다.
알파. API와 저장소 형태는 1.0 이전에 변경될 수 있습니다. DB는 추가 방식으로 자체 마이그레이션되지만, 가끔 변경 사항이 있을 수 있습니다. 이슈 및 PR 제출을 환영합니다 — 아래를 참조하세요.
CONTRIBUTING.md를 참조하세요. 요약: npm install && npm test, PR을 집중적으로 유지하고, 메모리 계층이나 오케스트레이터를 Passoff에 번들로 포함하지 마세요.
MIT — LICENSE를 참조하세요.
This server cannot be deployed
Cross-agent artifact workspace with provenance across Claude Code, Codex, Cursor, LangGraph.
Shared memory for AI coding agents. Save once, reuse from Cursor, Claude Code, Codex.
Shared, versioned context that humans and AI agents can publish, review, annotate, and continue.
Codebase graphs, caller impact analysis, and recorded project context for AI coding agents.
