bottari

Claude Code와 Codex CLI 설정이 한 대 이상의 기기에 걸쳐 있다면 — Windows, 오래된 Linux 노트북, Mac. bottari가 이를 동기화합니다: 스킬, 설정, 세션 기록, 프로젝트 폴더를 자신의 Google Drive에 암호화된 번들로 묶고, 모든 기기가 그 번들에 동기화됩니다. 암호화된 데이터만 컴퓨터 밖으로 나갑니다.

• 유니온 병합, 삭제 없음. 한쪽에 존재하는 것은 항상 유지됩니다. 같은 파일이 두 기기에서 변경된 경우에만 확인을 요청합니다.

• 버전 기록. 모든 동기화가 하나의 세대(generation)이며, bottari restore로 이전 상태를 언제든 되돌릴 수 있습니다.

• 종단 간 암호화. 클라우드에는 평문 파일 하나(암호화 매개변수와 래핑된 키)만 저장됩니다. 비밀번호를 잊으면 들어갈 방법이 없습니다 — 백도어는 없습니다.

• 의존성 제로. Node.js 20+만 있으면 됩니다.

상태: 0.1.0. Windows, Linux, macOS에서 매일 사용 중입니다. 초기 버전 — 미숙한 부분이 있을 수 있으며, 잃어버리면 안 되는 데이터를 맡기기 전에 SECURITY.md를 읽어보세요.

설치

Node.js 20 이상과 Google 계정이 필요합니다. Node는 node -v로 확인하세요. 없거나 오래된 버전이면 먼저 설치하세요(OS별 안내는 아래 참조).

Windows

# 1) Node — skip if `node -v` already prints v20+
winget install OpenJS.NodeJS.LTS

# 2) get bottari (pick one)
git clone https://github.com/dostevskii/bottari.git
#   or: download the ZIP from the green "Code" button and unzip it
cd bottari
npm link          # makes `bottari` available everywhere (optional)

macOS

# 1) Node — skip if `node -v` already prints v20+
#    with Homebrew:
brew install node
#    or download the LTS .pkg from https://nodejs.org

# 2) get bottari
git clone https://github.com/dostevskii/bottari.git
cd bottari
npm link          # optional; or run `node bin/bottari.mjs` directly

Linux

# 1) Node 20+ — use your distro (examples)
#    Arch:   sudo pacman -S nodejs npm
#    Debian/Ubuntu: sudo apt install nodejs npm   (check: node -v ≥ v20)
#    Fedora: sudo dnf install nodejs
# 2) get bottari
git clone https://github.com/dostevskii/bottari.git
cd bottari
# A desktop keyring (gnome-keyring + libsecret) is recommended so the
# sign-in is stored securely; without one, bottari falls back to a 0600
# file and warns.

Related MCP server: Ultimate Google Docs & Drive MCP Server

첫 실행

데이터가 가장 많은 기기(보통 주 기기)에서 다음을 실행하세요:

bottari init --remember-key

• 브라우저에서 Google에 로그인하고 비밀번호를 설정하라는 메시지가 표시됩니다.

• 이 비밀번호를 기억하세요. 전체 번들을 잠그며 복구할 수 없습니다.

• --remember-key는 키를 OS 자격 증명 저장소에 저장하여 다시 묻지 않게 합니다 — Claude Desktop 확장 프로그램도 비밀번호 없이 작동할 수 있습니다.

다른 모든 기기에서는 같은 명령을 실행하세요: bottari가 번들을 다운로드하고, 해당 기기와 병합한 후(각 기기에 고유한 것은 모두 유지), 결과를 업로드합니다.

그 후에는 일상적으로 다음만 실행하면 됩니다:

bottari sync

명령어

Claude Desktop (MCP)

bottari는 MCP 서버를 포함하여 데스크톱 앱에서 Claude가 이를 구동할 수 있게 합니다.

1. 번들 빌드: node scripts/build-mcpb.mjs → dist/bottari.mcpb

2. Claude Desktop → 설정 → 확장 프로그램 → bottari.mcpb를 끌어다 놓으세요.

터미널에서 bottari sync --remember-key를 한 번 실행한 후(키가 저장되면), Claude에게 이렇게 요청하세요: "내 bottari 상태 확인해줘" 또는 "bottari 동기화해줘". 충돌은 목록으로 반환되며, 선택하면 다음 동기화에 적용됩니다.

동기화 대상

자격 증명 파일(.credentials.json, auth.json, …)은 기기를 절대 떠나지 않으며, 자격 증명처럼 보이는 내용은 업로드 전에 fail-closed 스캔으로 차단됩니다. 재생성 가능한 폴더(node_modules, dist, …)와 캐시는 제외됩니다.

Google 계정

빌드에는 drive.file 범위로 제한된 OAuth 클라이언트가 포함되어 있습니다 — 이 앱이 만든 파일만 볼 수 있으며, Drive의 나머지 부분은 절대 볼 수 없습니다. 모든 Google 계정으로 로그인할 수 있습니다. 앱이 Google의 검증을 거치지 않았기 때문에(drive.file은 검증이 필요 없음), 브라우저에 "검증되지 않은 앱" 알림이 한 번 표시됩니다. 고급 → 계속을 눌러 진행하세요.

설치형 앱과 마찬가지로, 포함된 클라이언트는 비밀이 아닙니다(RFC 8252 §8.5) — bottari를 식별할 뿐, 사용자를 식별하지 않습니다. 포크하여 재배포하는 경우 자체 클라이언트를 등록하고 BOTTARI_CLIENT_ID / BOTTARI_CLIENT_SECRET을 설정하세요.

보안

설계 및 위협 모델: SECURITY.md. 동기화 모델 자체는 docs/SYNC-MODEL.md에 정의되어 있습니다.

라이선스

GPL-3.0-only · Copyright (C) 2026 JUNG HWANGBO <dostevskii@gmail.com>