cync-cli 0.4.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.4.0 → cync_cli-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cync-cli
-Version: 0.4.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
@@ -41,10 +41,13 @@ Requires-Dist: typer<1,>=0.12
 Provides-Extra: dev
 Requires-Dist: boto3<2,>=1.34; extra == 'dev'
 Requires-Dist: fastapi<1,>=0.110; extra == 'dev'
+Requires-Dist: mcp>=1.0; extra == 'dev'
 Requires-Dist: pydantic<3,>=2; extra == 'dev'
 Requires-Dist: pytest<9,>=8; extra == 'dev'
 Requires-Dist: ruff>=0.5; extra == 'dev'
 Requires-Dist: uvicorn[standard]<1,>=0.29; extra == 'dev'
+Provides-Extra: mcp
+Requires-Dist: mcp>=1.0; extra == 'mcp'
 Provides-Extra: server
 Requires-Dist: boto3<2,>=1.34; extra == 'server'
 Requires-Dist: fastapi<1,>=0.110; extra == 'server'
@@ -78,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`
@@ -152,6 +168,20 @@ The SvelteKit server holds the token (Supabase SSR cookies); browse at `/p/<proj
 | `cync project list` / `rm <name>` | manage your projects |
 | `cync --version` | print the version |
 
+## MCP server (optional)
+Let Claude (or any MCP host) read your synced conversations *as context* — pull a
+past chat into the model mid-conversation, not just sync files.
+
+```bash
+pipx install 'cync-cli[mcp]'   # the mcp extra
+cync login                     # the server uses your cync session
+```
+Add it to your MCP host (Claude Code `.mcp.json`, Claude Desktop config, etc.):
+```json
+{ "mcpServers": { "cync": { "command": "cync", "args": ["mcp"] } } }
+```
+Tools: `list_projects`, `list_conversations(project)`, `get_conversation(project, id)`.
+
 ## Migrating from v0.2
 If you have v0.2 (static-token) data still in R2, after `cync login`:
 ```bash

{cync_cli-0.4.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`
@@ -98,6 +111,20 @@ The SvelteKit server holds the token (Supabase SSR cookies); browse at `/p/<proj
 | `cync project list` / `rm <name>` | manage your projects |
 | `cync --version` | print the version |
 
+## MCP server (optional)
+Let Claude (or any MCP host) read your synced conversations *as context* — pull a
+past chat into the model mid-conversation, not just sync files.
+
+```bash
+pipx install 'cync-cli[mcp]'   # the mcp extra
+cync login                     # the server uses your cync session
+```
+Add it to your MCP host (Claude Code `.mcp.json`, Claude Desktop config, etc.):
+```json
+{ "mcpServers": { "cync": { "command": "cync", "args": ["mcp"] } } }
+```
+Tools: `list_projects`, `list_conversations(project)`, `get_conversation(project, id)`.
+
 ## Migrating from v0.2
 If you have v0.2 (static-token) data still in R2, after `cync login`:
 ```bash

{cync_cli-0.4.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.4.0 → cync_cli-0.6.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "cync-cli"
-version = "0.4.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"
@@ -34,8 +34,12 @@ server = [
     "boto3>=1.34,<2",
     "pydantic>=2,<3",
 ]
+mcp = [
+    "mcp>=1.0",
+]
 dev = [
     "cync-cli[server]",
+    "cync-cli[mcp]",
     "pytest>=8,<9",
     "ruff>=0.5",
 ]

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

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

{cync_cli-0.4.0 → cync_cli-0.6.0}/src/cync/client.py

@@ -416,6 +416,19 @@ def install_hooks(
     console.print("  · last-writer-wins; run [bold]cync install-hooks --uninstall[/] to remove")
 
 
+@app.command(name="mcp")
+def mcp_cmd() -> None:
+    """Run the cync MCP server (stdio) so MCP hosts can read your conversations."""
+    import sys
+
+    try:
+        from .mcp_server import run
+    except ImportError:
+        print("MCP support not installed — run: pipx install 'cync-cli[mcp]'", file=sys.stderr)
+        raise typer.Exit(1)
+    run()
+
+
 # ---- project management ----
 
 

cync_cli-0.6.0/src/cync/mcp_server.py

@@ -0,0 +1,132 @@
+"""cync MCP server — expose your synced conversations to MCP hosts.
+
+Run via `cync mcp` (stdio). Authenticates with your cync session (from
+`cync login`) and calls the cync API, so an MCP host (Claude Desktop, Claude
+Code, etc.) can read your conversations across machines as retrievable context.
+"""
+from __future__ import annotations
+
+import base64
+import json
+
+import httpx
+from mcp.server.fastmcp import FastMCP
+
+from . import auth, common
+from .config import ClientConfig
+
+mcp = FastMCP("cync")
+
+_MAX_CHARS = 30000  # cap transcript size returned to the model
+
+
+def _request(method: str, path: str, **kw) -> httpx.Response:
+    session = auth.load_session()
+    if not session:
+        raise RuntimeError("not signed in — run `cync login` in a terminal first")
+    server = ClientConfig.load().server_url
+    headers = {"Authorization": f"Bearer {session.access_token}"}
+    r = httpx.request(method, server + path, headers=headers, timeout=60.0, **kw)
+    if r.status_code == 401:
+        session = auth.refresh(session)
+        headers["Authorization"] = f"Bearer {session.access_token}"
+        r = httpx.request(method, server + path, headers=headers, timeout=60.0, **kw)
+    r.raise_for_status()
+    return r
+
+
+def _resolve_project(project: str) -> dict:
+    slug = common.slugify_project(project)
+    for p in _request("GET", "/projects").json():
+        if p.get("slug") == slug:
+            return p
+    raise ValueError(f"no project '{project}' — call list_projects() to see what's available")
+
+
+def _render(jsonl_text: str) -> str:
+    out: list[str] = []
+    for line in jsonl_text.splitlines():
+        line = line.strip()
+        if not line:
+            continue
+        try:
+            o = json.loads(line)
+        except Exception:
+            continue
+        typ = o.get("type")
+        if typ == "summary" and o.get("summary"):
+            out.append(f"[summary] {o['summary']}")
+            continue
+        if typ not in ("user", "assistant"):
+            continue
+        content = (o.get("message") or {}).get("content")
+        text = ""
+        if isinstance(content, str):
+            text = content
+        elif isinstance(content, list):
+            parts = []
+            for p in content:
+                if not isinstance(p, dict):
+                    continue
+                if p.get("type") == "text":
+                    parts.append(p.get("text", ""))
+                elif p.get("type") == "tool_use":
+                    parts.append(f"[tool: {p.get('name', '')}]")
+                elif p.get("type") == "tool_result":
+                    parts.append("[tool result]")
+            text = "\n".join(x for x in parts if x)
+        if text.strip() and not text.startswith("<"):
+            out.append(f"{typ}: {text}")
+    return "\n\n".join(out)
+
+
+@mcp.tool()
+def list_projects() -> list[dict]:
+    """List your cync projects (name, slug, and conversation count)."""
+    return [
+        {"slug": p["slug"], "name": p.get("name", ""), "conversations": p.get("count", 0)}
+        for p in _request("GET", "/projects").json()
+    ]
+
+
+@mcp.tool()
+def list_conversations(project: str) -> list[dict]:
+    """List conversations in a project (by slug): id, title, and updated time."""
+    proj = _resolve_project(project)
+    convs = _request("GET", f"/projects/{proj['id']}/conversations").json()
+    return [
+        {"id": c["id"], "title": c.get("title", ""), "updated": c.get("updated_at", "")}
+        for c in convs
+    ]
+
+
+@mcp.tool()
+def get_conversation(project: str, conversation_id: str) -> str:
+    """Fetch a past conversation's transcript as readable text, to use as context.
+
+    `project` is a slug; `conversation_id` is a full id or an unambiguous prefix.
+    """
+    proj = _resolve_project(project)
+    convs = _request("GET", f"/projects/{proj['id']}/conversations").json()
+    matches = [c["id"] for c in convs if c["id"].startswith(conversation_id)]
+    if not matches:
+        raise ValueError(f"no conversation matching '{conversation_id}'")
+    if len(matches) > 1:
+        raise ValueError(f"'{conversation_id}' is ambiguous ({len(matches)} matches)")
+    d = _request("GET", f"/projects/{proj['id']}/conversations/{matches[0]}").json()
+    text = _render(base64.b64decode(d["content_b64"]).decode("utf-8", "ignore"))
+    if len(text) > _MAX_CHARS:
+        text = "…(earlier messages truncated)…\n\n" + text[-_MAX_CHARS:]
+    return text or "(no renderable content)"
+
+
+def run() -> None:
+    """Run the stdio MCP server (used by `cync mcp`).
+
+    Silence per-request httpx logs — in stdio mode stdout must be a clean
+    JSON-RPC stream (the mcp SDK sends its own logs to stderr).
+    """
+    import logging
+
+    logging.getLogger("httpx").setLevel(logging.WARNING)
+    mcp.run()