cync-cli 0.5.0__tar.gz → 0.6.0__tar.gz

cync_cli-0.6.0/.github/workflows/release.yml

@@ -0,0 +1,139 @@
+name: release
+
+# Build standalone `cync` binaries with PyInstaller and publish them — plus an
+# updated Homebrew formula — to the PUBLIC tap repo. This source repo stays
+# private; only the compiled binaries + formula become public, so
+# `brew install 03hgryan/tap/cync` works for anyone.
+#
+# ── One-time setup ────────────────────────────────────────────────────────────
+#   1. Create a PUBLIC repo `03hgryan/homebrew-tap` (tick "Add a README" so it
+#      has an initial commit / default branch).
+#   2. Create a fine-grained PAT scoped to ONLY that repo, permission
+#      "Contents: Read and write". Add it to THIS repo as an Actions secret
+#      named `HOMEBREW_TAP_TOKEN` (Settings → Secrets and variables → Actions).
+# After that, every `git tag vX.Y.Z && git push --tags` ships binaries + formula.
+
+on:
+  push:
+    tags: ["v*"]
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: macos-14      # Apple Silicon
+            target: macos-arm64
+          - os: macos-13      # Intel
+            target: macos-x86_64
+          - os: ubuntu-latest
+            target: linux-x86_64
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Install build deps
+        run: |
+          python -m pip install --upgrade pip
+          pip install ".[mcp]" pyinstaller
+      - name: Build binary
+        run: |
+          pyinstaller --onefile --name cync \
+            --collect-all mcp \
+            --collect-all pydantic \
+            --collect-submodules anyio \
+            --hidden-import anyio._backends._asyncio \
+            --copy-metadata mcp \
+            --copy-metadata pydantic \
+            packaging/cync.py
+      - name: Smoke test
+        run: |
+          ./dist/cync --version
+          ./dist/cync --help >/dev/null
+          # MCP is bundled — prove it starts & imports cleanly (feed EOF so it exits).
+          ./dist/cync mcp </dev/null 2>mcp_err.txt &
+          pid=$!
+          sleep 5
+          rc=started
+          if ! kill -0 "$pid" 2>/dev/null; then
+            rc=0; wait "$pid" || rc=$?   # exited on its own: EOF→0 is fine, non-zero = crash
+          else
+            kill "$pid" 2>/dev/null || true; wait "$pid" 2>/dev/null || true
+          fi
+          if grep -qiE 'traceback|modulenotfound|importerror' mcp_err.txt; then
+            echo "::error::MCP failed to import in the bundled binary"; cat mcp_err.txt; exit 1
+          fi
+          if [ "$rc" != "started" ] && [ "$rc" != "0" ]; then
+            echo "::error::cync mcp exited early (rc=$rc) — likely a startup crash"; cat mcp_err.txt; exit 1
+          fi
+          echo "smoke ok (mcp rc=$rc)"
+      - name: Package tarball
+        run: tar -C dist -czf "cync-${{ matrix.target }}.tar.gz" cync
+      - uses: actions/upload-artifact@v4
+        with:
+          name: cync-${{ matrix.target }}
+          path: cync-${{ matrix.target }}.tar.gz
+
+  publish-tap:
+    needs: build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4        # for packaging/gen_formula.sh
+      - uses: actions/download-artifact@v4
+        with:
+          path: dist
+          merge-multiple: true
+      - name: Compute checksums
+        working-directory: dist
+        run: sha256sum *.tar.gz | tee SHA256SUMS
+      - name: Check tap token
+        env:
+          TAP_TOKEN: ${{ secrets.HOMEBREW_TAP_TOKEN }}
+        run: |
+          if [ -z "$TAP_TOKEN" ]; then
+            echo "::error::HOMEBREW_TAP_TOKEN not set — see the header of .github/workflows/release.yml"
+            exit 1
+          fi
+          # Fail fast on an expired/revoked/wrong-scoped token BEFORE creating the
+          # release — otherwise a bad token could upload assets, then 403 the
+          # formula push, leaving the tap with binaries but a stale formula.
+          code=$(curl -sS -o /dev/null -w '%{http_code}' \
+            -H "Authorization: Bearer $TAP_TOKEN" \
+            -H "Accept: application/vnd.github+json" \
+            https://api.github.com/repos/03hgryan/homebrew-tap)
+          if [ "$code" != "200" ]; then
+            echo "::error::HOMEBREW_TAP_TOKEN cannot reach 03hgryan/homebrew-tap (HTTP $code) — check it hasn't expired and has Contents: Read and write"
+            exit 1
+          fi
+          echo "tap token OK (repo reachable)"
+      - name: Publish binaries to the tap release
+        uses: softprops/action-gh-release@v2
+        with:
+          repository: 03hgryan/homebrew-tap
+          token: ${{ secrets.HOMEBREW_TAP_TOKEN }}
+          tag_name: ${{ github.ref_name }}
+          files: |
+            dist/*.tar.gz
+            dist/SHA256SUMS
+      - name: Update the Homebrew formula
+        env:
+          TAP_TOKEN: ${{ secrets.HOMEBREW_TAP_TOKEN }}
+          REF_NAME: ${{ github.ref_name }}
+        run: |
+          VER="${REF_NAME#v}"
+          bash packaging/gen_formula.sh "$VER" dist/SHA256SUMS > /tmp/cync.rb
+          git clone "https://x-access-token:${TAP_TOKEN}@github.com/03hgryan/homebrew-tap.git" tap
+          mkdir -p tap/Formula
+          cp /tmp/cync.rb tap/Formula/cync.rb
+          cd tap
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          git add Formula/cync.rb
+          git commit -m "cync ${VER}" || { echo "formula unchanged"; exit 0; }
+          git push

{cync_cli-0.5.0 → cync_cli-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cync-cli
-Version: 0.5.0
+Version: 0.6.0
 Summary: Sync Claude Code conversations across machines — GitHub-authed CLI + server (Postgres metadata, R2 blobs).
 Project-URL: Homepage, https://github.com/03hgryan/cync
 Project-URL: Repository, https://github.com/03hgryan/cync
@@ -81,17 +81,30 @@ Browser / CLI ── GitHub login (Supabase Auth) ──┐
 
 ## Install & use (hosted)
 
-The CLI is on PyPI as **`cync-cli`** (the command is `cync`). No server setup —
-it points at the hosted cync by default:
+The command is `cync`. No server setup — it points at the hosted cync by default.
 
+**Homebrew (macOS/Linux):**
+```bash
+brew install 03hgryan/tap/cync
+```
+
+**PyPI** (published as `cync-cli`):
 ```bash
 pipx install cync-cli        # or: uv tool install cync-cli
+```
+
+Then:
+```bash
 cync login                   # sign in with GitHub
 cd ~/path/to/your/project
 cync init myproject && cync push     # machine A
 cync link myproject && cync pull     # machine B → claude --resume
 ```
 
+> The Homebrew binary is a self-contained PyInstaller build (MCP included) served
+> from the public [`homebrew-tap`](https://github.com/03hgryan/homebrew-tap) repo;
+> see [`packaging/HOMEBREW.md`](packaging/HOMEBREW.md) for how releases are cut.
+
 ## Self-hosting
 
 Prefer your own stack? Point the CLI at your deployment via `CYNC_SERVER_URL`

{cync_cli-0.5.0 → cync_cli-0.6.0}/README.md

@@ -24,17 +24,30 @@ Browser / CLI ── GitHub login (Supabase Auth) ──┐
 
 ## Install & use (hosted)
 
-The CLI is on PyPI as **`cync-cli`** (the command is `cync`). No server setup —
-it points at the hosted cync by default:
+The command is `cync`. No server setup — it points at the hosted cync by default.
 
+**Homebrew (macOS/Linux):**
+```bash
+brew install 03hgryan/tap/cync
+```
+
+**PyPI** (published as `cync-cli`):
 ```bash
 pipx install cync-cli        # or: uv tool install cync-cli
+```
+
+Then:
+```bash
 cync login                   # sign in with GitHub
 cd ~/path/to/your/project
 cync init myproject && cync push     # machine A
 cync link myproject && cync pull     # machine B → claude --resume
 ```
 
+> The Homebrew binary is a self-contained PyInstaller build (MCP included) served
+> from the public [`homebrew-tap`](https://github.com/03hgryan/homebrew-tap) repo;
+> see [`packaging/HOMEBREW.md`](packaging/HOMEBREW.md) for how releases are cut.
+
 ## Self-hosting
 
 Prefer your own stack? Point the CLI at your deployment via `CYNC_SERVER_URL`

{cync_cli-0.5.0 → cync_cli-0.6.0}/client/src/routes/+layout.svelte

@@ -35,7 +35,8 @@
 <footer
 	style="max-width:880px;margin:0 auto;padding:16px 20px;color:#888;font-size:12px;border-top:1px solid #1d2027"
 >
-	<a href="/privacy">Privacy</a> · <a href="https://github.com/03hgryan/cync">GitHub</a>
+	<a href="/docs">Docs</a> · <a href="/privacy">Privacy</a> ·
+	<a href="https://github.com/03hgryan/cync">GitHub</a>
 </footer>
 
 <style>

cync_cli-0.6.0/client/src/routes/docs/+page.svelte

@@ -0,0 +1,92 @@
+<h1>cync docs</h1>
+<p class="muted">
+	Sync your Claude Code conversations across machines, signed in with GitHub. CLI +
+	hosted server; your metadata lives in Postgres, transcripts in R2.
+</p>
+
+<h2>Install</h2>
+<pre class="code">brew install 03hgryan/tap/cync   # macOS/Linux (Homebrew)
+# or
+pipx install cync-cli            # or: uv tool install cync-cli
+
+cync login                       # sign in with GitHub</pre>
+
+<h2>Quickstart</h2>
+<pre class="code"># machine A
+cync init myproject          # create a project + link this directory
+cync push                    # upload this repo's conversations
+
+# machine B
+cync link myproject
+cync pull                    # then: claude --resume</pre>
+
+<h2>Commands</h2>
+<table>
+	<tbody>
+		<tr><td><code>cync login</code> / <code>logout</code> / <code>whoami</code></td><td>GitHub auth session</td></tr>
+		<tr><td><code>cync init &lt;name&gt;</code></td><td>create a project + link this directory</td></tr>
+		<tr><td><code>cync link &lt;name&gt;</code></td><td>link this directory to an existing project</td></tr>
+		<tr><td><code>cync unlink</code></td><td>remove this directory's link</td></tr>
+		<tr><td><code>cync status</code></td><td>login, linked project, and local-vs-server sync state</td></tr>
+		<tr><td><code>cync push [id]</code></td><td>upload conversation(s)</td></tr>
+		<tr><td><code>cync pull [id]</code></td><td>download into <code>~/.claude</code></td></tr>
+		<tr><td><code>cync list</code></td><td>list this project's conversations</td></tr>
+		<tr><td><code>cync rm &lt;id&gt;</code></td><td>delete one server conversation (local copy kept)</td></tr>
+		<tr><td><code>cync open</code></td><td>open this project in the web viewer</td></tr>
+		<tr><td><code>cync install-hooks</code></td><td>auto-sync via Claude Code hooks</td></tr>
+		<tr><td><code>cync project list</code> / <code>rm</code></td><td>manage projects</td></tr>
+	</tbody>
+</table>
+
+<h2>Auto-sync (hooks)</h2>
+<p>Wire Claude Code to pull on session start and push on session end:</p>
+<pre class="code">cync install-hooks           # cync install-hooks --uninstall to remove</pre>
+
+<h2>MCP server</h2>
+<p>
+	Let Claude (or any MCP host) read your synced conversations <em>as context</em> —
+	pull a past chat into the model mid-conversation.
+</p>
+<pre class="code">pipx install 'cync-cli[mcp]'
+cync login</pre>
+<p>Add it to your MCP host (Claude Code <code>.mcp.json</code>, Claude Desktop config, …):</p>
+<pre class="code">{'{'} "mcpServers": {'{'} "cync": {'{'} "command": "cync", "args": ["mcp"] {'}'} {'}'} {'}'}</pre>
+<p class="muted">Tools: <code>list_projects</code>, <code>list_conversations(project)</code>, <code>get_conversation(project, id)</code>.</p>
+
+<h2>API (developers)</h2>
+<p>All data endpoints require a Supabase JWT (<code>Authorization: Bearer &lt;token&gt;</code>) and are scoped to your user.</p>
+<table>
+	<tbody>
+		<tr><td><code>GET /health</code> · <code>/config</code></td><td>liveness · public Supabase/web params</td></tr>
+		<tr><td><code>POST /projects</code></td><td>create a project <code>{'{'} name {'}'}</code></td></tr>
+		<tr><td><code>GET /projects</code></td><td>your projects</td></tr>
+		<tr><td><code>GET /projects/&#123;id&#125;/conversations</code></td><td>conversations in a project</td></tr>
+		<tr><td><code>GET /projects/&#123;id&#125;/conversations/&#123;cid&#125;</code></td><td>one conversation (base64 transcript)</td></tr>
+		<tr><td><code>PUT /conversations/&#123;cid&#125;</code></td><td>upsert a conversation</td></tr>
+		<tr><td><code>DELETE /conversations/&#123;cid&#125;</code> · <code>/projects/&#123;id&#125;</code></td><td>delete</td></tr>
+	</tbody>
+</table>
+
+<h2>Self-hosting</h2>
+<p>
+	Prefer your own stack? Deploy the server + your own Supabase + R2 and point the CLI
+	at it with <code>CYNC_SERVER_URL</code>. See the
+	<a href="https://github.com/03hgryan/cync">GitHub repo</a>.
+</p>
+
+<style>
+	h2 { margin-top: 28px; font-size: 16px; }
+	.code {
+		background: #15191f;
+		border: 1px solid #1d2027;
+		border-radius: 8px;
+		padding: 12px 14px;
+		overflow-x: auto;
+		font: 13px/1.5 ui-monospace, SFMono-Regular, Menlo, monospace;
+		white-space: pre;
+	}
+	table { border-collapse: collapse; width: 100%; }
+	td { border-bottom: 1px solid #1d2027; padding: 7px 8px; vertical-align: top; font-size: 13px; }
+	td:first-child { white-space: nowrap; padding-right: 16px; }
+	p { max-width: 680px; }
+</style>

cync_cli-0.6.0/packaging/HOMEBREW.md

@@ -0,0 +1,76 @@
+# Homebrew distribution
+
+`cync` ships to Homebrew as **standalone binaries** (PyInstaller `--onefile`,
+MCP bundled) so users don't need Python. Because this source repo is **private**
+and `brew` downloads release assets over unauthenticated HTTPS, the binaries and
+the formula live on a separate **public** repo: [`03hgryan/homebrew-tap`].
+
+```
+tag v0.6.0 on cync (private)
+      │
+      ▼  .github/workflows/release.yml
+build macos-arm64 / macos-x86_64 / linux-x86_64  (PyInstaller)
+      │
+      ▼  softprops/action-gh-release  (via HOMEBREW_TAP_TOKEN)
+03hgryan/homebrew-tap  ── releases/v0.6.0/cync-*.tar.gz  +  SHA256SUMS
+                       └─ Formula/cync.rb  (regenerated, points at those assets)
+      │
+      ▼
+brew install 03hgryan/tap/cync
+```
+
+## One-time setup
+
+1. **Create the tap repo.** New **public** repo `03hgryan/homebrew-tap`, tick
+   *"Add a README"* so it has an initial commit (the release step needs a
+   default branch to exist).
+
+2. **Create a scoped token.** GitHub → Settings → Developer settings →
+   **Fine-grained tokens**. Repository access: **only** `homebrew-tap`.
+   Permissions: **Contents → Read and write**. Copy the token.
+
+3. **Add it to the cync repo.** cync → Settings → Secrets and variables →
+   Actions → **New repository secret**, name `HOMEBREW_TAP_TOKEN`, paste the
+   token.
+
+## Cutting a release
+
+```bash
+# bump version in pyproject.toml + src/cync/__init__.py first, commit, then:
+git tag v0.6.0
+git push origin v0.6.0
+```
+
+That fires two workflows in parallel:
+- **publish.yml** → PyPI (`cync-cli`)
+- **release.yml** → builds binaries, uploads them + `SHA256SUMS` to the tap's
+  release, regenerates `Formula/cync.rb`, and pushes it to the tap.
+
+Verify:
+```bash
+brew update
+brew install 03hgryan/tap/cync   # or: brew upgrade cync
+cync --version
+```
+
+## Regenerating the formula by hand
+
+If you ever need to rebuild the formula outside CI (e.g. the tap push failed),
+download the release's `SHA256SUMS` from the tap and run:
+
+```bash
+bash packaging/gen_formula.sh 0.6.0 SHA256SUMS > Formula/cync.rb
+```
+
+## Notes / caveats
+
+- **Unsigned binaries.** The PyInstaller output isn't code-signed or notarized.
+  Homebrew installs via `curl` (no quarantine xattr), so it runs — but if a user
+  ever sees a Gatekeeper block, `xattr -dr com.apple.quarantine $(brew --prefix)/bin/cync`
+  clears it. Notarization is a future improvement.
+- **Startup cost.** `--onefile` unpacks to a temp dir on first run each launch;
+  fine for a CLI, slightly slower than a native binary.
+- **Platforms.** macOS arm64/x86_64 and Linux x86_64. Add `ubuntu-24.04-arm`
+  to the matrix + an `on_linux/on_arm` block in `gen_formula.sh` for Linux ARM.
+
+[`03hgryan/homebrew-tap`]: https://github.com/03hgryan/homebrew-tap

cync_cli-0.6.0/packaging/cync.py

@@ -0,0 +1,9 @@
+"""PyInstaller entry point for the standalone `cync` binary.
+
+PyInstaller needs a script path (not a module), so this thin wrapper calls the
+same entry point as the `cync` console script (`cync.client:main`).
+"""
+from cync.client import main
+
+if __name__ == "__main__":
+    main()

cync_cli-0.6.0/packaging/gen_formula.sh

@@ -0,0 +1,63 @@
+#!/usr/bin/env bash
+# Generate the Homebrew formula for cync from a SHA256SUMS file.
+#
+#   gen_formula.sh <version-without-v> [SHA256SUMS-path]  > cync.rb
+#
+# Binaries live on the PUBLIC tap repo's releases (this source repo is private),
+# so the formula's download URLs point there, not at the cync repo.
+set -euo pipefail
+
+VERSION="${1:?usage: gen_formula.sh <version> [sums-file]}"
+SUMS="${2:-SHA256SUMS}"
+TAP_OWNER="${TAP_OWNER:-03hgryan}"
+TAP_REPO="${TAP_REPO:-homebrew-tap}"
+BASE="https://github.com/${TAP_OWNER}/${TAP_REPO}/releases/download/v${VERSION}"
+
+# Pull one checksum out of the `sha256sum` output (format: "<hash>  <file>").
+sha() {
+  local line
+  line=$(grep " cync-$1\.tar\.gz\$" "$SUMS") || {
+    echo "gen_formula: no checksum for cync-$1.tar.gz in $SUMS" >&2
+    exit 1
+  }
+  echo "${line%% *}"
+}
+
+ARM=$(sha macos-arm64)
+INTEL=$(sha macos-x86_64)
+LINUX=$(sha linux-x86_64)
+
+cat <<EOF
+class Cync < Formula
+  desc "Sync Claude Code conversations across machines"
+  homepage "https://cync-topaz.vercel.app/docs"
+  version "${VERSION}"
+  license "MIT"
+
+  on_macos do
+    on_arm do
+      url "${BASE}/cync-macos-arm64.tar.gz"
+      sha256 "${ARM}"
+    end
+    on_intel do
+      url "${BASE}/cync-macos-x86_64.tar.gz"
+      sha256 "${INTEL}"
+    end
+  end
+
+  on_linux do
+    on_intel do
+      url "${BASE}/cync-linux-x86_64.tar.gz"
+      sha256 "${LINUX}"
+    end
+  end
+
+  def install
+    bin.install "cync"
+  end
+
+  test do
+    assert_match version.to_s, shell_output("#{bin}/cync --version")
+  end
+end
+EOF

{cync_cli-0.5.0 → cync_cli-0.6.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "cync-cli"
-version = "0.5.0"
+version = "0.6.0"
 description = "Sync Claude Code conversations across machines — GitHub-authed CLI + server (Postgres metadata, R2 blobs)."
 readme = "README.md"
 requires-python = ">=3.11"

{cync_cli-0.5.0 → cync_cli-0.6.0}/src/cync/__init__.py

@@ -1,3 +1,3 @@
 """cync — sync Claude Code conversations across machines."""
 
-__version__ = "0.5.0"
+__version__ = "0.6.0"