bottari

Ihre Claude Code- und Codex-CLI-Einrichtung lebt auf mehr als einem Rechner — Windows, einem alten Linux-Laptop, einem Mac. bottari hält sie synchron: Es packt Ihre Skills, Einstellungen, Sitzungsverlauf und Projektordner in ein verschlüsseltes Bündel auf Ihrem eigenen Google Drive, und jeder Rechner synchronisiert sich damit. Nur verschlüsselte Daten verlassen jemals Ihren Computer.

• Union-Merge, nichts wird gelöscht. Was auf einer Seite existiert, bleibt immer erhalten. Sie werden nur gefragt, wenn dieselbe Datei auf zwei Rechnern geändert wurde.

• Versionsverlauf. Jede Synchronisierung ist eine Generation; bottari restore stellt jeden früheren Zustand wieder her.

• Ende-zu-Ende verschlüsselt. Die Cloud enthält eine Klartextdatei (Verschlüsselungsparameter und einen eingehüllten Schlüssel). Wenn Sie Ihr Passwort vergessen, gibt es keinen Weg hinein — es gibt keine Hintertür.

• Null Abhängigkeiten. Node.js 20+ und sonst nichts.

Status: 0.1.0. Im täglichen Einsatz unter Windows, Linux und macOS. Früh — erwarten Sie raue Kanten, und lesen Sie SECURITY.md, bevor Sie ihm etwas anvertrauen, das Sie nicht verlieren können.

Installation

Sie benötigen Node.js 20 oder neuer und ein Google-Konto. Prüfen Sie Node mit node -v; wenn es fehlt oder älter ist, installieren Sie es zuerst (pro Betriebssystem unten).

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

Erster Start

Auf dem Rechner mit den meisten Daten (normalerweise Ihrem Hauptrechner) führen Sie Folgendes aus:

bottari init --remember-key

• Es meldet Sie im Browser bei Google an und fordert Sie auf, ein Passwort festzulegen.

• Merken Sie sich dieses Passwort. Es sperrt das gesamte Bündel und kann nicht wiederhergestellt werden.

• --remember-key speichert den Schlüssel im OS-Anmeldeinformationsspeicher, sodass Sie nicht erneut gefragt werden — und damit die Claude Desktop-Erweiterung ohne ihn funktionieren kann.

Auf jedem anderen Rechner führen Sie denselben Befehl aus: bottari lädt das Bündel herunter, führt einen Merge mit diesem Rechner durch (wobei alles erhalten bleibt, was für jeden Rechner einzigartig ist) und lädt das Ergebnis hoch.

Danach ist es im Alltag einfach nur:

bottari sync

Befehle

Claude Desktop (MCP)

bottari enthält einen MCP-Server, damit Claude ihn aus der Desktop-App steuern kann.

1. Bündel erstellen: node scripts/build-mcpb.mjs → dist/bottari.mcpb

2. Claude Desktop → Einstellungen → Erweiterungen → bottari.mcpb hineinziehen.

Sobald Sie bottari sync --remember-key einmal in einem Terminal ausgeführt haben (damit der Schlüssel gespeichert ist), fragen Sie Claude einfach: "check my bottari status" oder "sync bottari". Konflikte kommen als Liste zurück; Sie wählen, und die nächste Synchronisierung wendet sie an.

Was synchronisiert wird

Anmeldeinformationsdateien (.credentials.json, auth.json, …) verlassen Ihren Rechner nie, und ein Fail-Closed-Scan blockiert jeden anmeldeinformations- ähnlichen Inhalt vor dem Hochladen. Regenerierbare Ordner (node_modules, dist, …) und Caches sind ausgeschlossen.

Google-Konto

Der Build enthält einen OAuth-Client, der auf drive.file beschränkt ist — er sieht nur Dateien, die diese App erstellt hat, niemals den Rest Ihres Drive. Jedes Google-Konto kann sich anmelden. Da die App nicht durch die Google-Verifizierung läuft (die drive.file nicht erfordert), zeigt der Browser einmalig einen Hinweis "Unverified app" (nicht verifizierte App); über Erweitert → Weiter geht es weiter.

Wie bei jeder installierten App ist der eingebettete Client kein Geheimnis (RFC 8252 §8.5) — er identifiziert bottari, nicht Sie. Wenn Sie einen Fork erstellen und weiterverteilen, registrieren Sie Ihren eigenen Client und setzen Sie BOTTARI_CLIENT_ID / BOTTARI_CLIENT_SECRET.

Sicherheit

Design und Bedrohungsmodell: SECURITY.md. Das Synchronisierungsmodell selbst ist in docs/SYNC-MODEL.md definiert.

Lizenz

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