두레박 · Durebak

서로 다른 코딩 에이전트 세션을 잇는 로컬 협업 도구.

Local, durable collaboration between coding-agent sessions. Experimental alpha for Claude Code, Codex and OpenCode integrations.

두레박은 같은 컴퓨터의 코딩 에이전트 세션이 메시지·작업·결과를 주고받는 로컬 협업 런타임입니다. 각 세션은 자기 호스트와 맥락을 유지하고, CLI 또는 MCP로 참여합니다.

현재 소스: 0.1.0-alpha.24. 사용자용 협업은 Cooperative 모드입니다. SQLite 저장소, 인증된 loopback 서버, CLI, MCP stdio bridge가 구현되어 있습니다. 실제 MCP 프로세스 간 통신을 테스트했으며, 호스트별 실제 시험 결과와 제약은 호스트 테스트에 기록합니다. 요청별 대화·기한·취소 notice·checkpoint, 공유 preview, 보호 작업·비공개 텍스트 첨부, revision별 자기보고 검증·재검증과 CLI 협업 화면을 제공합니다. 내부 실험용 Codex·OpenCode 소유 호스트와 실행 ledger, 비동기 준비 상태 검사도 개발 중입니다. 이 내부 구성의 실제 모델 실행·controller 연결·자동 깨우기는 아직 검증하지 않았습니다. 자동 세션 실행·깨우기와 반복 작업 스케줄러는 후속 기능입니다.

npm·GitHub 설치/업데이트 경로, 릴리스 구독과 alpha.24의 update-check·opt-in 알림은 설치·업데이트 안내를 참고하세요.

시작하기

macOS 또는 Linux, Node.js 24 이상과 npm이 필요합니다. Windows는 이 alpha에서 지원하지 않습니다. Windows CI의 ACL·SQLite 조사는 지원 준비를 위한 시험이며, 제품 실행 검증과 구분합니다.

npx로 alpha 버전을 실행할 수 있습니다.

npx --yes durebak@alpha --help
npx --yes durebak@alpha serve

npm dist-tag와 현재 소스 버전은 다를 수 있습니다. npm view durebak dist-tags로 게시 버전을 확인하고 정확한 버전을 지정하세요. 새 후보의 npm 게시가 막힌 경우 GitHub Releases의 검증된 .tgz와 SHA256SUMS를 확인해 npm install --global ./durebak-VERSION.tgz로 설치할 수 있습니다. 서버는 foreground에서 실행하며 Ctrl-C로 종료합니다.

git에서 직접 실행하려면:

git clone https://github.com/ggujunhi247/durebak.git
cd durebak
npm ci
npm run build
node dist/cli.js --help
node dist/cli.js serve

세션 등록, MCP 연결, 요청·답변과 결과 제출은 사용법을 따릅니다. 새 설치는 사용자 홈의 ~/.durebak에 데이터를 보관합니다. 기존 데이터 위치와 명시적인 경로 설정은 유지합니다. register와 export에서 --out을 생략하면 인증 파일과 기록도 같은 데이터 디렉터리에 저장됩니다. npx --yes durebak@alpha paths로 실제 위치를 확인할 수 있습니다.

Related MCP server: openswarm

검증 상태

• 실제 Codex → Codex 요청·검토·결과 제출을 검증했습니다.

• Claude Code·OpenCode 설정 어댑터와 6방향 시험 도구를 제공합니다. 이종 모델 간 실통신 성공은 아직 검증하지 못했습니다.

• 자동 테스트와 실제 MCP 프로세스 왕복 검사를 통과했습니다. Linux·macOS 원격 CI에서도 테스트와 패키지 검사를 통과했습니다.

• durebak dashboard --session FILE에서 원문 없이 연락·요청·검증 상태를 확인합니다. bridge 접촉은 실제 host 준비 증거가 아닙니다.

• 자동 세션 깨우기·네이티브 대화 재개·무인 반복 개선은 아직 지원하지 않습니다.

자세한 버전과 제한은 호환성을 확인하세요.

지금 할 수 있는 일

• 세션별 credential과 workspace 격리로 요청·답변을 교환합니다.

• SQLite WAL에 저장하고 동일 idempotency key의 중복 전송을 억제합니다.

• 우선순위·대기 시간·세션 상태에 따라 메시지를 전달하고, 수신 확인과 재시도를 관리합니다.

• 메시지의 읽음 확인과 작업의 수락·결과 제출을 구분합니다.

• 작업 version을 비교해 중복 수락이나 오래된 결과 제출을 거부합니다.

• 산출물을 내용 hash로 보존하고 UTF-8 원문을 최대 4 KiB씩 조회합니다.

• 원문 조회의 파생 캐시를 재사용하고, 모델 호출 없이 작업 기록을 Markdown으로 내보냅니다.

completed는 담당자가 결과를 제출했다는 뜻입니다. 독립 검토·검증에 의한 성공 판정은 아직 구현하지 않았습니다. 다른 세션의 메시지는 데이터이며 사용자의 권한을 확장하는 지시가 아닙니다.

검증과 개발

npm run check
npm test
npm run package:check
npm run lab

테스트는 실제 SQLite·loopback HTTP·MCP subprocess를 사용하며 모델 API를 호출하지 않습니다. Node 24의 macOS/Linux CI를 구성했습니다. 실제 실행 환경과 검증 범위는 구현 현황에 기록합니다.

실제 모델을 사용하는 시험은 npm run lab:live로 별도 실행합니다. 계정 사용량이 발생하며 기본 대상은 Codex와 Claude입니다.

매뉴얼

배포

Apache-2.0 라이선스의 실험적 알파입니다. 소스 저장소는 ggujunhi247/durebak입니다. 검증을 마친 버전의 배포 파일은 GitHub prerelease에서 제공합니다. GitHub 배포와 npm 게시는 별개입니다. npm의 현재 게시 버전은 npm view durebak dist-tags로 별도 확인하세요. CI/CD는 검증된 동일 artifact를 protected npm environment와 trusted publisher를 통해 게시하도록 구성되어 있으며, 인증·게시권한 확인이 남으면 소스 또는 GitHub 배포 파일을 사용합니다.

제품명은 두레박, 영문 브랜드와 CLI 식별자는 Durebak / durebak입니다.

메시지 전달 정책: 큐·중요도·대기·확인 규칙. 새 클라이언트는 receive와 ack(id,receipt)를 사용한다.

협업 스킬 (개발 소스)

durebak skills --harness all --workspace PROJECT로 Codex·Claude Code·OpenCode용 공통 협업 안내와 호출 entry point를 설치합니다. Codex는 $durebak, Claude Code/OpenCode는 /durebak에서 요청·받기·응답·검증을 진행합니다. 각 세션의 별도 MCP/credential 연결은 필요하며 자동 native 깨우기는 아직 지원하지 않습니다. 설치·사용 계약을 참고하세요.