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

{cync_cli-0.3.0 → cync_cli-0.4.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.4.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.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cync-cli
-Version: 0.3.0
+Version: 0.4.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
@@ -142,10 +142,15 @@ 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 |
 
 ## 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.4.0}/README.md

@@ -88,10 +88,15 @@ 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 |
 
 ## 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.4.0}/pyproject.toml

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

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

{cync_cli-0.3.0 → cync_cli-0.4.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,104 @@ 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")
+
+
 # ---- project management ----
 
 

{cync_cli-0.3.0 → cync_cli-0.4.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.3.0 → cync_cli-0.4.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 ----