@tawandotorg/claude-sync 0.4.0

package/.githooks/pre-commit

@@ -0,0 +1,31 @@
+#!/bin/bash
+
+set -e
+
+echo "Running pre-commit checks..."
+
+# Run go fmt
+echo "Checking formatting..."
+UNFORMATTED=$(gofmt -l .)
+if [ -n "$UNFORMATTED" ]; then
+    echo "Error: The following files are not formatted:"
+    echo "$UNFORMATTED"
+    echo "Run 'go fmt ./...' to fix."
+    exit 1
+fi
+
+# Run go vet
+echo "Running go vet..."
+go vet ./...
+
+# Run tests
+echo "Running tests..."
+go test ./... -short
+
+# Run golangci-lint if available
+if command -v golangci-lint &> /dev/null; then
+    echo "Running golangci-lint..."
+    golangci-lint run
+fi
+
+echo "All checks passed!"

package/.releaserc.json

@@ -0,0 +1,23 @@
+{
+  "branches": ["main"],
+  "plugins": [
+    "@semantic-release/commit-analyzer",
+    "@semantic-release/release-notes-generator",
+    "@semantic-release/changelog",
+    ["@semantic-release/exec", {
+      "prepareCmd": "VERSION=${nextRelease.version} make build-all"
+    }],
+    ["@semantic-release/git", {
+      "assets": ["CHANGELOG.md"],
+      "message": "chore(release): ${nextRelease.version} [skip ci]\n\n${nextRelease.notes}"
+    }],
+    ["@semantic-release/github", {
+      "assets": [
+        {"path": "bin/claude-sync-darwin-arm64", "label": "claude-sync-darwin-arm64"},
+        {"path": "bin/claude-sync-darwin-amd64", "label": "claude-sync-darwin-amd64"},
+        {"path": "bin/claude-sync-linux-amd64", "label": "claude-sync-linux-amd64"},
+        {"path": "bin/claude-sync-linux-arm64", "label": "claude-sync-linux-arm64"}
+      ]
+    }]
+  ]
+}

package/CHANGELOG.md

@@ -0,0 +1,62 @@
+# [0.4.0](https://github.com/tawanorg/claude-sync/compare/v0.3.2...v0.4.0) (2026-02-08)
+
+
+### Bug Fixes
+
+* remove unused promptInput function ([0cf28ee](https://github.com/tawanorg/claude-sync/commit/0cf28eeca5a340e85c0ece250fa26a3db75c3cea))
+
+
+### Features
+
+* add multi-provider storage support (R2, S3, GCS) ([ded6fe8](https://github.com/tawanorg/claude-sync/commit/ded6fe8937dce96c77cba4cac9d904728047b5c1))
+* add npm package for easy installation ([2e3c62f](https://github.com/tawanorg/claude-sync/commit/2e3c62f08e32a8b8171a0a27d6e0cc7d9410156a))
+
+## [0.3.2](https://github.com/tawanorg/claude-sync/compare/v0.3.1...v0.3.2) (2026-02-08)
+
+
+### Bug Fixes
+
+* use git tags for version instead of hardcoded value ([972f0e8](https://github.com/tawanorg/claude-sync/commit/972f0e8da314d47eaff64368c38d80fe5b4a0eca))
+
+## [0.3.1](https://github.com/tawanorg/claude-sync/compare/v0.3.0...v0.3.1) (2026-02-08)
+
+
+### Bug Fixes
+
+* handle unchecked error returns for linter ([2390505](https://github.com/tawanorg/claude-sync/commit/23905053d96612b43314e4291df644f6bc7763af))
+
+# [0.3.0](https://github.com/tawanorg/claude-sync/compare/v0.2.1...v0.3.0) (2026-02-08)
+
+
+### Features
+
+* add update command for self-updating CLI ([4c91357](https://github.com/tawanorg/claude-sync/commit/4c9135767dcafdf4b9d78b86e0dd3b84078b22bf))
+
+## [0.2.1](https://github.com/tawanorg/claude-sync/compare/v0.2.0...v0.2.1) (2026-02-08)
+
+
+### Bug Fixes
+
+* resolve deprecated API warnings ([f1c9559](https://github.com/tawanorg/claude-sync/commit/f1c955937034fe66449bcc87b1542d9c71c58eb7))
+
+# [0.2.0](https://github.com/tawanorg/claude-sync/compare/v0.1.1...v0.2.0) (2026-02-08)
+
+
+### Features
+
+* add reset command for forgot passphrase recovery ([3cd1cdb](https://github.com/tawanorg/claude-sync/commit/3cd1cdbd1964e108d312e2739fd4938f7a43eaf5))
+
+## [0.1.1](https://github.com/tawanorg/claude-sync/compare/v0.1.0...v0.1.1) (2026-02-08)
+
+
+### Bug Fixes
+
+* correct Go version to 1.21 in go.mod ([28146ef](https://github.com/tawanorg/claude-sync/commit/28146efb234b699ad96a5e0b4ebcbec80299a21c))
+* use Linux-compatible sed in semantic-release ([4a5fb37](https://github.com/tawanorg/claude-sync/commit/4a5fb37697deae23a73db14cfd3c4bca3b34cffc))
+
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

package/README.md

@@ -0,0 +1,291 @@
+<div align="center">
+
+<img src="assets/banner.svg" alt="Claude Sync" width="100%">
+
+<br>
+
+*Encrypted with [age](https://github.com/FiloSottile/age) • R2 / S3 / GCS supported*
+
+[![Release](https://img.shields.io/github/v/release/tawanorg/claude-sync)](https://github.com/tawanorg/claude-sync/releases)
+[![Go](https://img.shields.io/badge/Go-1.21+-00ADD8?logo=go)](https://go.dev)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+[Quick Start](#quick-start) • [Setup Guide](#setup-guide) • [Commands](#commands) • [Security](#security)
+
+</div>
+
+---
+
+## Features
+
+- **Cross-device sync**: Continue Claude Code conversations on any laptop
+- **Multi-provider storage**: Cloudflare R2, AWS S3, or Google Cloud Storage
+- **End-to-end encryption**: All files encrypted with age before upload
+- **Passphrase-based keys**: Same passphrase = same key on any device (no file copying)
+- **Interactive wizard**: Arrow-key driven setup with validation
+- **Self-updating**: `claude-sync update` to get the latest version
+- **Simple CLI**: `push`, `pull`, `status`, `diff`, `conflicts` commands
+
+## Quick Start
+
+### First Device
+
+```bash
+# Install (pick one)
+npm install -g claude-sync
+# or: go install github.com/tawanorg/claude-sync/cmd/claude-sync@latest
+
+# Set up (interactive wizard)
+claude-sync init
+
+# Push your sessions
+claude-sync push
+```
+
+### Second Device
+
+```bash
+# Install
+npm install -g claude-sync
+
+# Set up with SAME storage credentials and SAME passphrase
+claude-sync init
+
+# Pull sessions
+claude-sync pull
+```
+
+**That's it!** Same passphrase = same encryption key. No file copying needed.
+
+## Setup Guide
+
+### Step 1: Choose a Storage Provider
+
+| Provider | Free Tier | Best For |
+|----------|-----------|----------|
+| **Cloudflare R2** | 10GB storage | Personal use (recommended) |
+| **AWS S3** | 5GB (12 months) | AWS users |
+| **Google Cloud Storage** | 5GB | GCP users |
+
+### Step 2: Create a Bucket
+
+<details>
+<summary><b>Cloudflare R2</b> (recommended)</summary>
+
+1. Go to [Cloudflare Dashboard](https://dash.cloudflare.com/) → R2 Object Storage
+2. Click "Create bucket" → name it `claude-sync`
+3. Go to "Manage R2 API Tokens" → "Create API Token"
+4. Select **Object Read & Write** permission → Create
+
+You'll need: Account ID, Access Key ID, Secret Access Key
+</details>
+
+<details>
+<summary><b>AWS S3</b></summary>
+
+1. Go to [S3 Console](https://s3.console.aws.amazon.com/s3/bucket/create) → Create bucket
+2. Go to [IAM Security Credentials](https://console.aws.amazon.com/iam/home#/security_credentials)
+3. Create Access Keys
+
+You'll need: Access Key ID, Secret Access Key, Region
+</details>
+
+<details>
+<summary><b>Google Cloud Storage</b></summary>
+
+1. Go to [Cloud Storage](https://console.cloud.google.com/storage/create-bucket) → Create bucket
+2. Go to [Service Accounts](https://console.cloud.google.com/iam-admin/serviceaccounts) → Create service account
+3. Grant "Storage Object Admin" role → Create JSON key
+
+You'll need: Project ID, Service Account JSON file (or use `gcloud auth application-default login`)
+</details>
+
+### Step 3: Run Init
+
+```bash
+claude-sync init
+```
+
+The interactive wizard will guide you through:
+
+1. **Select storage provider** (R2, S3, or GCS)
+2. **Enter credentials** (provider-specific)
+3. **Choose encryption method**:
+   - **Passphrase** (recommended) - same passphrase on all devices = same key
+   - **Random key** - must copy `~/.claude-sync/age-key.txt` to other devices
+4. **Test the connection** to verify everything works
+
+### Step 4: Push and Pull
+
+```bash
+# Upload local changes
+claude-sync push
+
+# Download remote changes
+claude-sync pull
+```
+
+## What Gets Synced
+
+| Path | Content |
+|------|---------|
+| `~/.claude/projects/` | Session files, auto-memory |
+| `~/.claude/history.jsonl` | Command history |
+| `~/.claude/agents/` | Custom agents |
+| `~/.claude/skills/` | Custom skills |
+| `~/.claude/plugins/` | Plugins |
+| `~/.claude/rules/` | Custom rules |
+| `~/.claude/settings.json` | Settings |
+| `~/.claude/CLAUDE.md` | Global instructions |
+
+## Commands
+
+```bash
+claude-sync init        # Set up configuration (interactive wizard)
+claude-sync push        # Upload local changes to cloud storage
+claude-sync pull        # Download remote changes from cloud storage
+claude-sync status      # Show pending local changes
+claude-sync diff        # Show differences between local and remote
+claude-sync conflicts   # List and resolve conflicts
+claude-sync reset       # Reset configuration (forgot passphrase)
+claude-sync update      # Update to latest version
+claude-sync --help      # Show all commands
+```
+
+### Quiet Mode
+
+```bash
+claude-sync push -q     # No output (for scripts)
+claude-sync pull -q
+```
+
+### Check for Updates
+
+```bash
+claude-sync update --check   # Check without installing
+claude-sync update           # Download and install latest version
+```
+
+## Shell Integration
+
+Add to `~/.zshrc` or `~/.bashrc`:
+
+```bash
+# Auto-pull on shell start
+if command -v claude-sync &> /dev/null; then
+  claude-sync pull -q &
+fi
+
+# Auto-push on shell exit
+trap 'claude-sync push -q' EXIT
+```
+
+## Conflict Resolution
+
+When both local and remote files change, the remote version is saved as `.conflict`:
+
+```bash
+claude-sync conflicts            # Interactive resolution
+claude-sync conflicts --list     # Just list conflicts
+claude-sync conflicts --keep local   # Keep all local versions
+claude-sync conflicts --keep remote  # Keep all remote versions
+```
+
+Interactive options:
+- **[l]** Keep local (delete conflict file)
+- **[r]** Keep remote (replace local)
+- **[d]** Show diff
+- **[s]** Skip
+- **[q]** Quit
+
+## Forgot Passphrase?
+
+The passphrase is **never stored**. If you forget it:
+
+1. Your encrypted files cannot be recovered
+2. Reset and start fresh:
+
+```bash
+claude-sync reset --remote   # Delete remote files and local config
+claude-sync init             # Set up again with new passphrase
+claude-sync push             # Re-upload from this device
+```
+
+## Security
+
+- Files encrypted with [age](https://github.com/FiloSottile/age) before upload
+- Passphrase-derived keys use Argon2 (memory-hard KDF)
+- Passphrase is never stored - only the derived key at `~/.claude-sync/age-key.txt`
+- Cloud storage is private (API key/IAM auth)
+- Config files stored with 0600 permissions
+
+## Cost
+
+Claude sessions typically use < 50MB. Syncing is effectively **free** on any provider:
+
+| Provider | Free Tier |
+|----------|-----------|
+| **Cloudflare R2** | 10GB storage, 1M writes, 10M reads/month |
+| **AWS S3** | 5GB for 12 months (then ~$0.023/GB) |
+| **Google Cloud Storage** | 5GB, 5K writes, 50K reads/month |
+
+## Installation Options
+
+### npm (recommended)
+
+```bash
+# One-time use
+npx claude-sync init
+
+# Global install
+npm install -g claude-sync
+```
+
+### Go Install
+
+```bash
+go install github.com/tawanorg/claude-sync/cmd/claude-sync@latest
+```
+
+### Build Manually
+
+```bash
+git clone https://github.com/tawanorg/claude-sync
+cd claude-sync
+make build
+./bin/claude-sync --version
+```
+
+### Download Binary
+
+Download from [GitHub Releases](https://github.com/tawanorg/claude-sync/releases):
+
+```bash
+# macOS ARM (M1/M2/M3)
+curl -L https://github.com/tawanorg/claude-sync/releases/latest/download/claude-sync-darwin-arm64 -o claude-sync
+chmod +x claude-sync
+sudo mv claude-sync /usr/local/bin/
+
+# macOS Intel
+curl -L https://github.com/tawanorg/claude-sync/releases/latest/download/claude-sync-darwin-amd64 -o claude-sync
+
+# Linux AMD64
+curl -L https://github.com/tawanorg/claude-sync/releases/latest/download/claude-sync-linux-amd64 -o claude-sync
+
+# Linux ARM64
+curl -L https://github.com/tawanorg/claude-sync/releases/latest/download/claude-sync-linux-arm64 -o claude-sync
+```
+
+## Development
+
+```bash
+make test          # Run tests
+make fmt           # Format code
+make check         # Run all pre-commit checks
+make build-all     # Build for all platforms
+make setup-hooks   # Enable git pre-commit hooks
+```
+
+## License
+
+MIT

package/bin/claude-sync.js

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+
+const { spawn } = require("child_process");
+const path = require("path");
+const fs = require("fs");
+
+function getBinaryPath() {
+  const platform = process.platform;
+  const binaryName = platform === "win32" ? "claude-sync.exe" : "claude-sync";
+  const binaryPath = path.join(__dirname, binaryName);
+
+  if (!fs.existsSync(binaryPath)) {
+    console.error("Error: claude-sync binary not found.");
+    console.error("Try reinstalling: npm install -g claude-sync");
+    process.exit(1);
+  }
+
+  return binaryPath;
+}
+
+const binary = getBinaryPath();
+const args = process.argv.slice(2);
+
+const child = spawn(binary, args, {
+  stdio: "inherit",
+  env: process.env,
+});
+
+child.on("error", (err) => {
+  console.error(`Failed to start claude-sync: ${err.message}`);
+  process.exit(1);
+});
+
+child.on("close", (code) => {
+  process.exit(code || 0);
+});

package/install.js

@@ -0,0 +1,116 @@
+#!/usr/bin/env node
+
+const https = require("https");
+const fs = require("fs");
+const path = require("path");
+const { execSync } = require("child_process");
+
+const VERSION = require("./package.json").version;
+const REPO = "tawanorg/claude-sync";
+
+function getPlatform() {
+  const platform = process.platform;
+  switch (platform) {
+    case "darwin":
+      return "darwin";
+    case "linux":
+      return "linux";
+    case "win32":
+      return "windows";
+    default:
+      throw new Error(`Unsupported platform: ${platform}`);
+  }
+}
+
+function getArch() {
+  const arch = process.arch;
+  switch (arch) {
+    case "x64":
+      return "amd64";
+    case "arm64":
+      return "arm64";
+    default:
+      throw new Error(`Unsupported architecture: ${arch}`);
+  }
+}
+
+function getBinaryName() {
+  const platform = getPlatform();
+  const arch = getArch();
+  const ext = platform === "windows" ? ".exe" : "";
+  return `claude-sync-${platform}-${arch}${ext}`;
+}
+
+function getDownloadUrl() {
+  const binaryName = getBinaryName();
+  return `https://github.com/${REPO}/releases/download/v${VERSION}/${binaryName}`;
+}
+
+function download(url, dest) {
+  return new Promise((resolve, reject) => {
+    const file = fs.createWriteStream(dest);
+
+    const request = (url) => {
+      https
+        .get(url, (response) => {
+          // Handle redirects
+          if (response.statusCode === 302 || response.statusCode === 301) {
+            request(response.headers.location);
+            return;
+          }
+
+          if (response.statusCode !== 200) {
+            reject(new Error(`Failed to download: ${response.statusCode}`));
+            return;
+          }
+
+          response.pipe(file);
+          file.on("finish", () => {
+            file.close();
+            resolve();
+          });
+        })
+        .on("error", (err) => {
+          fs.unlink(dest, () => {});
+          reject(err);
+        });
+    };
+
+    request(url);
+  });
+}
+
+async function install() {
+  const binDir = path.join(__dirname, "bin");
+  const platform = getPlatform();
+  const binaryName = platform === "windows" ? "claude-sync.exe" : "claude-sync";
+  const binaryPath = path.join(binDir, binaryName);
+
+  // Create bin directory
+  if (!fs.existsSync(binDir)) {
+    fs.mkdirSync(binDir, { recursive: true });
+  }
+
+  const url = getDownloadUrl();
+  console.log(`Downloading claude-sync v${VERSION}...`);
+  console.log(`  Platform: ${getPlatform()}-${getArch()}`);
+
+  try {
+    await download(url, binaryPath);
+
+    // Make executable on Unix
+    if (platform !== "windows") {
+      fs.chmodSync(binaryPath, 0o755);
+    }
+
+    console.log(`  Installed to: ${binaryPath}`);
+    console.log(`\n✓ claude-sync installed successfully!`);
+  } catch (err) {
+    console.error(`\n✗ Failed to install claude-sync: ${err.message}`);
+    console.error(`\nYou can manually download from:`);
+    console.error(`  ${url}`);
+    process.exit(1);
+  }
+}
+
+install();

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@tawandotorg/claude-sync",
+  "version": "0.4.0",
+  "description": "Sync Claude Code sessions across devices with encrypted cloud storage",
+  "bin": {
+    "claude-sync": "./bin/claude-sync.js"
+  },
+  "scripts": {
+    "postinstall": "node install.js"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "sync",
+    "cli",
+    "anthropic",
+    "ai",
+    "r2",
+    "s3",
+    "gcs",
+    "encryption"
+  ],
+  "author": "tawanorg",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tawanorg/claude-sync.git"
+  },
+  "bugs": {
+    "url": "https://github.com/tawanorg/claude-sync/issues"
+  },
+  "homepage": "https://github.com/tawanorg/claude-sync#readme",
+  "engines": {
+    "node": ">=14"
+  },
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ]
+}