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

{cync_cli-0.3.0 → cync_cli-0.5.0}/.env.example

@@ -22,6 +22,8 @@ SUPABASE_SERVICE_ROLE_KEY=your_supabase_service_role_key
 CYNC_HOST=127.0.0.1
 CYNC_PORT=8787
 # CYNC_MAX_BODY_BYTES=67108864   # 64 MB request-body cap
+# Public web viewer URL, advertised via /config so `cync open` can find it:
+# CYNC_WEB_URL=https://your-cync-web.vercel.app
 
 # ---- hosted-service policy (optional) ----
 # Access: restrict to specific GitHub emails/usernames (comma-separated). Empty = open.

{cync_cli-0.3.0 → cync_cli-0.5.0}/Dockerfile

@@ -4,7 +4,8 @@ FROM python:3.12-slim
 WORKDIR /app
 
 # Install the package + server extras (fastapi, uvicorn, boto3, pydantic).
-COPY pyproject.toml ./
+# README.md + LICENSE are needed because pyproject references them (readme/license).
+COPY pyproject.toml README.md LICENSE ./
 COPY src ./src
 RUN pip install --no-cache-dir ".[server]"
 

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cync-cli
-Version: 0.3.0
+Version: 0.5.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'
@@ -142,10 +145,29 @@ The SvelteKit server holds the token (Supabase SSR cookies); browse at `/p/<proj
 | `cync init <name>` | create a project + link this directory |
 | `cync link <name>` | link this directory to an existing project |
 | `cync unlink` | remove this directory's link |
+| `cync status` | show login, linked project, and local-vs-server sync state |
 | `cync push [id]` | upload this project's conversation(s) |
 | `cync pull [id]` | download into `~/.claude` (overwrite/add) |
 | `cync list` | list this project's conversations |
+| `cync rm <id>` | delete one conversation from the server (local copy kept) |
+| `cync open` | open the web viewer for this project |
+| `cync install-hooks` | auto-sync via Claude Code hooks (pull on start, push on end) |
 | `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`:

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

@@ -88,10 +88,29 @@ The SvelteKit server holds the token (Supabase SSR cookies); browse at `/p/<proj
 | `cync init <name>` | create a project + link this directory |
 | `cync link <name>` | link this directory to an existing project |
 | `cync unlink` | remove this directory's link |
+| `cync status` | show login, linked project, and local-vs-server sync state |
 | `cync push [id]` | upload this project's conversation(s) |
 | `cync pull [id]` | download into `~/.claude` (overwrite/add) |
 | `cync list` | list this project's conversations |
+| `cync rm <id>` | delete one conversation from the server (local copy kept) |
+| `cync open` | open the web viewer for this project |
+| `cync install-hooks` | auto-sync via Claude Code hooks (pull on start, push on end) |
 | `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`:

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

@@ -1,6 +1,6 @@
 [project]
 name = "cync-cli"
-version = "0.3.0"
+version = "0.5.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.3.0 → cync_cli-0.5.0}/src/cync/__init__.py

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

{cync_cli-0.3.0 → cync_cli-0.5.0}/src/cync/client.py

@@ -16,7 +16,7 @@ import typer
 from rich.console import Console
 from rich.table import Table
 
-from . import auth, common
+from . import __version__, auth, common
 from .config import ClientConfig, get_link, remove_link, set_link
 
 app = typer.Typer(add_completion=False, help="Sync Claude Code conversations across machines.")
@@ -25,6 +25,22 @@ app.add_typer(project_app, name="project")
 console = Console()
 
 
+def _version_callback(value: bool) -> None:
+    if value:
+        console.print(f"cync {__version__}")
+        raise typer.Exit()
+
+
+@app.callback()
+def _main(
+    version: bool = typer.Option(
+        False, "--version", callback=_version_callback, is_eager=True,
+        help="Show the cync version and exit.",
+    ),
+) -> None:
+    """Sync Claude Code conversations across machines."""
+
+
 def _check(r: httpx.Response) -> None:
     if r.is_success:
         return
@@ -147,6 +163,41 @@ def whoami() -> None:
     console.print(user.get("email") or user.get("id") or "(unknown)")
 
 
+@app.command()
+def status() -> None:
+    """Show login, the linked project, and local-vs-server sync state."""
+    root = _repo_root()
+    console.print(f"dir:     {root}")
+    session = auth.load_session()
+    pid = get_link(root)
+    if not session:
+        console.print("login:   [yellow]not logged in[/] (run `cync login`)")
+    if not pid:
+        console.print("project: [yellow]not linked[/] (run `cync init <name>` or `cync link <name>`)")
+    if not session or not pid:
+        return
+    api = Api()
+    user = auth.current_user(session)
+    console.print(f"login:   {user.get('email') or user.get('id')}")
+    r = api.get("/projects")
+    _check(r)
+    proj = next((p for p in r.json() if p["id"] == pid), None)
+    console.print(f"project: {proj['slug'] if proj else '[red]link points to a missing project[/]'}")
+    folder = common.claude_projects_dir() / common.encode_project_dir(root)
+    local = {f.stem for f in common.list_local_conversations(folder)}
+    rr = api.get("/conversations", params={"project_id": pid})
+    _check(rr)
+    server = {m["id"] for m in rr.json()}
+    console.print(
+        f"sync:    {len(local & server)} synced · "
+        f"{len(local - server)} local-only · {len(server - local)} server-only"
+    )
+    if local - server:
+        console.print(f"  [yellow]push these:[/] {', '.join(sorted(s[:8] for s in (local - server)))}")
+    if server - local:
+        console.print(f"  [cyan]pull these:[/] {', '.join(sorted(s[:8] for s in (server - local)))}")
+
+
 # ---- project linking ----
 
 
@@ -267,6 +318,117 @@ def list_cmd() -> None:
     console.print(table)
 
 
+@app.command()
+def rm(
+    id: str = typer.Argument(..., help="conversation id or prefix to delete from the server"),
+    yes: bool = typer.Option(False, "--yes", "-y", help="skip confirmation"),
+) -> None:
+    """Delete a single conversation from the server (your local copy is untouched)."""
+    api = Api()
+    _root, pid, _folder = _linked()
+    r = api.get("/conversations", params={"project_id": pid})
+    _check(r)
+    matches = [m["id"] for m in r.json() if m["id"].startswith(id)]
+    if not matches:
+        console.print(f"[yellow]no conversation matching '{id}'[/]")
+        raise typer.Exit(1)
+    if len(matches) > 1:
+        console.print(f"[red]'{id}' is ambiguous[/] ({len(matches)} matches) — use more characters")
+        raise typer.Exit(1)
+    full = matches[0]
+    if not yes:
+        typer.confirm(f"delete conversation {full[:8]} from the server?", abort=True)
+    rr = api.delete(f"/conversations/{full}", params={"project_id": pid})
+    _check(rr)
+    console.print(f"[green]deleted[/] {full[:8]} from the server (local copy kept)")
+
+
+@app.command(name="open")
+def open_cmd() -> None:
+    """Open the web viewer for this project in your browser."""
+    import webbrowser
+
+    server = ClientConfig.load().server_url
+    web = os.environ.get("CYNC_WEB_URL") or ""
+    if not web:
+        try:
+            web = httpx.get(f"{server}/config", timeout=15).json().get("web_url") or ""
+        except Exception:
+            web = ""
+    web = web.rstrip("/")
+    if not web:
+        console.print("[yellow]web viewer URL unknown[/] — set CYNC_WEB_URL or configure it on the server")
+        raise typer.Exit(1)
+    url = web
+    pid = get_link(_repo_root())
+    if pid and auth.load_session():
+        r = Api().get("/projects")
+        if r.is_success:
+            proj = next((p for p in r.json() if p["id"] == pid), None)
+            if proj:
+                url = f"{web}/p/{proj['slug']}"
+    console.print(f"opening {url}")
+    webbrowser.open(url)
+
+
+@app.command(name="install-hooks")
+def install_hooks(
+    uninstall: bool = typer.Option(False, "--uninstall", help="remove cync's Claude Code hooks"),
+) -> None:
+    """Auto-sync via Claude Code hooks: pull on session start, push on session end."""
+    settings = common.claude_projects_dir().parent / "settings.json"  # ~/.claude/settings.json
+    settings.parent.mkdir(parents=True, exist_ok=True)
+    data: dict = {}
+    if settings.exists():
+        try:
+            data = json.loads(settings.read_text())
+        except Exception:
+            data = {}
+    hooks = data.setdefault("hooks", {})
+
+    def _strip(event: str) -> None:
+        kept = [
+            e for e in hooks.get(event, [])
+            if not any("cync" in h.get("command", "") for h in e.get("hooks", []))
+        ]
+        if kept:
+            hooks[event] = kept
+        else:
+            hooks.pop(event, None)
+
+    _strip("SessionStart")
+    _strip("SessionEnd")
+    if uninstall:
+        if not hooks:
+            data.pop("hooks", None)
+        settings.write_text(json.dumps(data, indent=2))
+        console.print("removed cync hooks")
+        return
+    hooks.setdefault("SessionStart", []).append(
+        {"hooks": [{"type": "command", "command": "cync pull >/dev/null 2>&1 || true"}]}
+    )
+    hooks.setdefault("SessionEnd", []).append(
+        {"hooks": [{"type": "command", "command": "cync push >/dev/null 2>&1 || true"}]}
+    )
+    settings.write_text(json.dumps(data, indent=2))
+    console.print(f"[green]installed[/] Claude Code hooks in {settings}")
+    console.print("  · pull on session start, push on session end (only for linked dirs)")
+    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.3.0 → cync_cli-0.5.0}/src/cync/config.py

@@ -18,6 +18,7 @@ class ServerConfig:
     token: str
     supabase_url: str
     supabase_anon_key: str
+    web_url: str
 
     @classmethod
     def from_env(cls) -> "ServerConfig":
@@ -33,6 +34,7 @@ class ServerConfig:
             token=os.environ.get("CYNC_TOKEN", ""),
             supabase_url=os.environ.get("SUPABASE_URL", "").rstrip("/"),
             supabase_anon_key=os.environ.get("SUPABASE_ANON_KEY", ""),
+            web_url=os.environ.get("CYNC_WEB_URL", "").rstrip("/"),
         )
 
 

cync_cli-0.5.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()

{cync_cli-0.3.0 → cync_cli-0.5.0}/src/cync/server.py

@@ -132,7 +132,11 @@ def health() -> dict:
 @app.get("/config")
 def public_config() -> dict:
     """Public Supabase params for the CLI/web login flow (the anon key is public)."""
-    return {"supabase_url": cfg.supabase_url, "supabase_anon_key": cfg.supabase_anon_key}
+    return {
+        "supabase_url": cfg.supabase_url,
+        "supabase_anon_key": cfg.supabase_anon_key,
+        "web_url": cfg.web_url,
+    }
 
 
 # ---- projects ----