syncanything 0.3.0__tar.gz → 0.3.2__tar.gz

{syncanything-0.3.0/src/syncanything.egg-info → syncanything-0.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: syncanything
-Version: 0.3.0
+Version: 0.3.2
 Summary: An agent-native context index across AI products.
 Author: Chizhong Wang
 License-Expression: MIT
@@ -41,7 +41,7 @@ SyncAnything is a local, agent-native index for conversations across AI products
 
 Phase 1 is intentionally read-only:
 
-- discovers local Claude Code, Codex, Kimi Code, and Pi sessions;
+- discovers local Claude Code, Codex, Cursor, Kimi Code, and Pi sessions;
 - connects to CiteAnything as a product-level context source;
 - indexes visible user and assistant text in SQLite FTS5;
 - searches Chinese and English conversation text;
@@ -68,7 +68,7 @@ For a single headless connection:
 
 ```bash
 export SYNCANYTHING_CITEANYTHING_API_KEY="ca_your_context_read_key"
-export CITEANYTHING_BASE_URL="https://citeanything.veri-glow.com"
+export CITEANYTHING_BASE_URL="https://citeanything.app"
 syncanything index
 syncanything serve --no-index
 ```
@@ -216,7 +216,9 @@ Start the stdio server with:
 syncanything mcp
 ```
 
-Example MCP client configuration:
+### Claude Code
+
+Add to `~/.claude/settings.json` or the project `.mcp.json`:
 
 ```json
 {
@@ -229,6 +231,23 @@ Example MCP client configuration:
 }
 ```
 
+### Cursor
+
+Add to `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (per-project):
+
+```json
+{
+  "mcpServers": {
+    "syncanything": {
+      "command": "syncanything",
+      "args": ["mcp"]
+    }
+  }
+}
+```
+
+Restart Cursor after saving. The MCP server appears under **Settings → MCP** when connected.
+
 For a non-default local home or database, keep the database and connection metadata together. If `--db` is supplied and `SYNCANYTHING_HOME` is not set, SyncAnything infers the home directory from the database parent:
 
 ```json
@@ -284,16 +303,18 @@ rather than re-downloaded.
 
 ## Source support
 
-| Source | Location | Phase 1 status |
-|---|---|---|
-| Claude Code | `~/.claude/projects/**/*.jsonl` | Verified locally |
-| Codex | `~/.codex/sessions/**/*.jsonl` | Verified locally |
-| Kimi Code (legacy) | `~/.kimi/sessions/*/*/context.jsonl` | Verified locally |
-| Kimi Code (current) | `~/.kimi-code/sessions/*/*/agents/main/wire.jsonl` | Adapter included |
-| Pi | `~/.pi/agent/sessions/**/*.jsonl` | Official format implemented |
-| CiteAnything | Authenticated Conversation API | Product-level adapter included |
-| OpenCode | SQLite session store | Next adapter |
-| Grok Build | Pending stable local export contract | Next adapter |
+| | Source | Location | Phase 1 status |
+|---|---|---|---|
+| <img src="docs/logos/claudecode-color.svg" width="20" alt="Claude Code"> | Claude Code | `~/.claude/projects/**/*.jsonl` | Verified locally |
+| <img src="docs/logos/codex-color.svg" width="20" alt="Codex"> | Codex | `~/.codex/sessions/**/*.jsonl` | Verified locally |
+| <img src="docs/logos/cursor.svg" width="20" alt="Cursor"> | Cursor App | `state.vscdb` (composerHeaders + cursorDiskKV) | Verified locally |
+| <img src="docs/logos/cursor.svg" width="20" alt="Cursor"> | Cursor CLI | `~/.cursor/chats/*/*/meta.json` + `agent-transcripts` | Verified locally |
+| <img src="docs/logos/kimi-color.svg" width="20" alt="Kimi Code"> | Kimi Code (legacy) | `~/.kimi/sessions/*/*/context.jsonl` | Verified locally |
+| <img src="docs/logos/kimi-color.svg" width="20" alt="Kimi Code"> | Kimi Code (current) | `~/.kimi-code/sessions/*/*/agents/main/wire.jsonl` | Adapter included |
+| <img src="docs/logos/pi.svg" width="20" alt="Pi"> | Pi | `~/.pi/agent/sessions/**/*.jsonl` | Official format implemented |
+| <img src="docs/logos/citeanything.png" width="20" alt="CiteAnything"> | CiteAnything | Authenticated Conversation API | Product-level adapter included |
+| <img src="docs/logos/opencode.svg" width="20" alt="OpenCode"> | OpenCode | SQLite session store | Next adapter |
+| <img src="docs/logos/grok.svg" width="20" alt="Grok Build"> | Grok Build | Pending stable local export contract | Next adapter |
 
 ## Development
 

{syncanything-0.3.0 → syncanything-0.3.2}/README.md

@@ -12,7 +12,7 @@ SyncAnything is a local, agent-native index for conversations across AI products
 
 Phase 1 is intentionally read-only:
 
-- discovers local Claude Code, Codex, Kimi Code, and Pi sessions;
+- discovers local Claude Code, Codex, Cursor, Kimi Code, and Pi sessions;
 - connects to CiteAnything as a product-level context source;
 - indexes visible user and assistant text in SQLite FTS5;
 - searches Chinese and English conversation text;
@@ -39,7 +39,7 @@ For a single headless connection:
 
 ```bash
 export SYNCANYTHING_CITEANYTHING_API_KEY="ca_your_context_read_key"
-export CITEANYTHING_BASE_URL="https://citeanything.veri-glow.com"
+export CITEANYTHING_BASE_URL="https://citeanything.app"
 syncanything index
 syncanything serve --no-index
 ```
@@ -187,7 +187,9 @@ Start the stdio server with:
 syncanything mcp
 ```
 
-Example MCP client configuration:
+### Claude Code
+
+Add to `~/.claude/settings.json` or the project `.mcp.json`:
 
 ```json
 {
@@ -200,6 +202,23 @@ Example MCP client configuration:
 }
 ```
 
+### Cursor
+
+Add to `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (per-project):
+
+```json
+{
+  "mcpServers": {
+    "syncanything": {
+      "command": "syncanything",
+      "args": ["mcp"]
+    }
+  }
+}
+```
+
+Restart Cursor after saving. The MCP server appears under **Settings → MCP** when connected.
+
 For a non-default local home or database, keep the database and connection metadata together. If `--db` is supplied and `SYNCANYTHING_HOME` is not set, SyncAnything infers the home directory from the database parent:
 
 ```json
@@ -255,16 +274,18 @@ rather than re-downloaded.
 
 ## Source support
 
-| Source | Location | Phase 1 status |
-|---|---|---|
-| Claude Code | `~/.claude/projects/**/*.jsonl` | Verified locally |
-| Codex | `~/.codex/sessions/**/*.jsonl` | Verified locally |
-| Kimi Code (legacy) | `~/.kimi/sessions/*/*/context.jsonl` | Verified locally |
-| Kimi Code (current) | `~/.kimi-code/sessions/*/*/agents/main/wire.jsonl` | Adapter included |
-| Pi | `~/.pi/agent/sessions/**/*.jsonl` | Official format implemented |
-| CiteAnything | Authenticated Conversation API | Product-level adapter included |
-| OpenCode | SQLite session store | Next adapter |
-| Grok Build | Pending stable local export contract | Next adapter |
+| | Source | Location | Phase 1 status |
+|---|---|---|---|
+| <img src="docs/logos/claudecode-color.svg" width="20" alt="Claude Code"> | Claude Code | `~/.claude/projects/**/*.jsonl` | Verified locally |
+| <img src="docs/logos/codex-color.svg" width="20" alt="Codex"> | Codex | `~/.codex/sessions/**/*.jsonl` | Verified locally |
+| <img src="docs/logos/cursor.svg" width="20" alt="Cursor"> | Cursor App | `state.vscdb` (composerHeaders + cursorDiskKV) | Verified locally |
+| <img src="docs/logos/cursor.svg" width="20" alt="Cursor"> | Cursor CLI | `~/.cursor/chats/*/*/meta.json` + `agent-transcripts` | Verified locally |
+| <img src="docs/logos/kimi-color.svg" width="20" alt="Kimi Code"> | Kimi Code (legacy) | `~/.kimi/sessions/*/*/context.jsonl` | Verified locally |
+| <img src="docs/logos/kimi-color.svg" width="20" alt="Kimi Code"> | Kimi Code (current) | `~/.kimi-code/sessions/*/*/agents/main/wire.jsonl` | Adapter included |
+| <img src="docs/logos/pi.svg" width="20" alt="Pi"> | Pi | `~/.pi/agent/sessions/**/*.jsonl` | Official format implemented |
+| <img src="docs/logos/citeanything.png" width="20" alt="CiteAnything"> | CiteAnything | Authenticated Conversation API | Product-level adapter included |
+| <img src="docs/logos/opencode.svg" width="20" alt="OpenCode"> | OpenCode | SQLite session store | Next adapter |
+| <img src="docs/logos/grok.svg" width="20" alt="Grok Build"> | Grok Build | Pending stable local export contract | Next adapter |
 
 ## Development
 

{syncanything-0.3.0 → syncanything-0.3.2}/src/syncanything/__init__.py

@@ -1,3 +1,3 @@
 """SyncAnything: one local index for conversations across AI coding tools."""
 
-__version__ = "0.3.0"
+__version__ = "0.3.2"

{syncanything-0.3.0 → syncanything-0.3.2}/src/syncanything/cli.py

@@ -47,14 +47,14 @@ def build_parser() -> argparse.ArgumentParser:
     search_parser = subparsers.add_parser("search", help="Search indexed sessions.")
     search_parser.add_argument("query")
     search_parser.add_argument(
-        "--source", choices=["claude", "codex", "kimi", "pi", "citeanything"]
+        "--source", choices=["claude", "codex", "cursor", "kimi", "pi", "citeanything"]
     )
     search_parser.add_argument("--limit", type=int, default=20)
     search_parser.add_argument("--json", action="store_true")
 
     list_parser = subparsers.add_parser("list", help="List recent sessions.")
     list_parser.add_argument(
-        "--source", choices=["claude", "codex", "kimi", "pi", "citeanything"]
+        "--source", choices=["claude", "codex", "cursor", "kimi", "pi", "citeanything"]
     )
     list_parser.add_argument("--limit", type=int, default=30)
     list_parser.add_argument("--json", action="store_true")

{syncanything-0.3.0 → syncanything-0.3.2}/src/syncanything/connections.py

@@ -16,7 +16,7 @@ from typing import Any
 
 KEYCHAIN_SERVICE = "SyncAnything.CiteAnything"
 SITE_URLS = {
-    "international": "https://citeanything.veri-glow.com",
+    "international": "https://citeanything.app",
     "china": "https://citeanything.cn",
 }
 

{syncanything-0.3.0 → syncanything-0.3.2}/src/syncanything/index.py

@@ -160,22 +160,40 @@ class ConversationIndex:
         except ValueError:
             return 0.0
 
+    #: Remote sources are synced at most once per this interval during reads.
+    REMOTE_SYNC_INTERVAL: float = float(os.environ.get("SYNCANYTHING_REMOTE_SYNC_INTERVAL", "300"))
+
     def refresh(self, max_age_seconds: float = 2.0, force: bool = False) -> dict[str, Any] | None:
-        """Incrementally re-index local sources before a read.
+        """Incrementally re-index sources before a read.
 
-        Scanning every local session file costs about 15ms, so this runs inline on
-        search, list, show, reference, and status. Remote sources are excluded: their
-        discover() performs HTTP requests and belongs to explicit `index` or `serve`.
-        Returns None when a recent refresh made this call unnecessary.
+        Local sources are scanned on every call (throttled to *max_age_seconds*).
+        Remote sources (CiteAnything) are synced when their last pull is older
+        than ``REMOTE_SYNC_INTERVAL`` (default 5 min, env-configurable).
         """
-        if not force and (time.time() - self.last_refresh("local")) < max_age_seconds:
-            return None
-        sources = self.adapters if self.adapters is not None else local_adapters()
-        local = [adapter for adapter in sources if not adapter.is_remote]
-        if not local:
-            return None
-        report = self.index_all(adapters=local)
-        self._set_meta("last_refresh:local", str(time.time()))
+        now = time.time()
+        report: dict[str, Any] | None = None
+
+        if force or (now - self.last_refresh("local")) >= max_age_seconds:
+            sources = self.adapters if self.adapters is not None else local_adapters()
+            local = [adapter for adapter in sources if not adapter.is_remote]
+            if local:
+                report = self.index_all(adapters=local)
+                self._set_meta("last_refresh:local", str(now))
+
+        if force or (now - self.last_refresh("remote")) >= self.REMOTE_SYNC_INTERVAL:
+            all_sources = self.adapters if self.adapters is not None else default_adapters()
+            remote = [adapter for adapter in all_sources if adapter.is_remote]
+            if remote:
+                remote_report = self.index_all(adapters=remote)
+                self._set_meta("last_refresh:remote", str(now))
+                if report is None:
+                    report = remote_report
+                else:
+                    for key in ("indexed", "unchanged", "empty", "skipped", "removed"):
+                        report[key] += remote_report.get(key, 0)
+                    report["errors"].extend(remote_report.get("errors", []))
+                    report["sources"].update(remote_report.get("sources", {}))
+
         return report
 
     def index_all(

{syncanything-0.3.0 → syncanything-0.3.2}/src/syncanything/mcp.py

@@ -19,7 +19,7 @@ TOOLS = [
                 "query": {"type": "string", "description": "Exact text or phrase to find."},
                 "source": {
                     "type": "string",
-                    "description": "Optional source filter: claude, codex, kimi, pi, or citeanything.",
+                    "description": "Optional source filter: claude, codex, cursor, kimi, pi, or citeanything.",
                 },
                 "limit": {"type": "integer", "minimum": 1, "maximum": 100, "default": 20},
             },

{syncanything-0.3.0 → syncanything-0.3.2}/src/syncanything/sources/__init__.py

@@ -2,12 +2,13 @@ from syncanything.sources.base import SourceAdapter
 from syncanything.sources.citeanything import CiteAnythingAdapter
 from syncanything.sources.claude import ClaudeAdapter
 from syncanything.sources.codex import CodexAdapter
+from syncanything.sources.cursor import CursorAdapter
 from syncanything.sources.kimi import KimiAdapter
 from syncanything.sources.pi import PiAdapter
 
 
 def default_adapters() -> list[SourceAdapter]:
-    return [ClaudeAdapter(), CodexAdapter(), KimiAdapter(), PiAdapter(), CiteAnythingAdapter()]
+    return [ClaudeAdapter(), CodexAdapter(), CursorAdapter(), KimiAdapter(), PiAdapter(), CiteAnythingAdapter()]
 
 
 def local_adapters() -> list[SourceAdapter]:
@@ -21,6 +22,7 @@ __all__ = [
     "CiteAnythingAdapter",
     "ClaudeAdapter",
     "CodexAdapter",
+    "CursorAdapter",
     "KimiAdapter",
     "PiAdapter",
     "default_adapters",

{syncanything-0.3.0 → syncanything-0.3.2}/src/syncanything/sources/citeanything.py

@@ -57,7 +57,7 @@ class CiteAnythingAdapter(SourceAdapter):
         self.base_url = (
             base_url
             or os.environ.get("CITEANYTHING_BASE_URL")
-            or "https://citeanything.veri-glow.com"
+            or "https://citeanything.app"
         ).rstrip("/")
         self.api_key = (
             api_key
@@ -109,7 +109,7 @@ class CiteAnythingAdapter(SourceAdapter):
         host = base_url.split("://", 1)[-1].split("/", 1)[0].lower()
         if host == "citeanything.cn":
             return "china"
-        if host == "citeanything.veri-glow.com":
+        if host in {"citeanything.app", "citeanything.veri-glow.com"}:
             return "international"
         return "".join(
             character if character.isalnum() else "-" for character in host

syncanything-0.3.2/src/syncanything/sources/cursor.py

@@ -0,0 +1,397 @@
+from __future__ import annotations
+
+import json
+import re
+import sqlite3
+import sys
+from datetime import datetime, timezone
+from pathlib import Path
+from typing import Any, Iterable
+
+from syncanything.connections import syncanything_home
+from syncanything.models import Message, Session
+from syncanything.sources.base import SourceAdapter, choose_title, read_jsonl, visible_text
+
+_BUBBLE_TYPE_USER = 1
+_BUBBLE_TYPE_ASSISTANT = 2
+_USER_QUERY_RE = re.compile(r"<user_query>\s*(.*?)\s*</user_query>", re.DOTALL | re.IGNORECASE)
+_TIMESTAMP_RE = re.compile(r"<timestamp>\s*.*?\s*</timestamp>\s*", re.DOTALL | re.IGNORECASE)
+
+
+def _cursor_data_root() -> Path:
+    if sys.platform == "darwin":
+        return Path.home() / "Library" / "Application Support" / "Cursor"
+    if sys.platform == "win32":
+        return Path.home() / "AppData" / "Roaming" / "Cursor"
+    return Path.home() / ".config" / "Cursor"
+
+
+def _cursor_cli_chats_root() -> Path:
+    return Path.home() / ".cursor" / "chats"
+
+
+def _cursor_projects_root() -> Path:
+    return Path.home() / ".cursor" / "projects"
+
+
+def _find_state_dbs() -> list[Path]:
+    root = _cursor_data_root() / "User"
+    if not root.exists():
+        return []
+    candidates = [root / "globalStorage" / "state.vscdb"]
+    workspace_storage = root / "workspaceStorage"
+    if workspace_storage.exists():
+        for workspace in workspace_storage.iterdir():
+            candidates.append(workspace / "state.vscdb")
+    return [path for path in candidates if path.exists()]
+
+
+def _ms_to_iso(ms: int | None) -> str | None:
+    if not isinstance(ms, int) or ms <= 0:
+        return None
+    return datetime.fromtimestamp(ms / 1000, tz=timezone.utc).isoformat()
+
+
+def _clean_cli_user_text(text: str) -> str:
+    """Prefer the <user_query> body when Cursor CLI wraps the turn."""
+    match = _USER_QUERY_RE.search(text)
+    if match:
+        return match.group(1).strip()
+    cleaned = _TIMESTAMP_RE.sub("", text).strip()
+    return cleaned or text.strip()
+
+
+def _write_cache(cache_path: Path, snapshot: dict[str, Any]) -> None:
+    cache_path.parent.mkdir(parents=True, exist_ok=True)
+    encoded = json.dumps(snapshot, ensure_ascii=False, sort_keys=True) + "\n"
+    temporary = cache_path.with_suffix(".json.tmp")
+    temporary.write_text(encoded, encoding="utf-8")
+    temporary.replace(cache_path)
+
+
+def _cached_matches(cache_path: Path, last_updated: Any) -> bool:
+    if not cache_path.exists():
+        return False
+    try:
+        cached = json.loads(cache_path.read_text(encoding="utf-8"))
+    except (OSError, json.JSONDecodeError):
+        return False
+    return isinstance(cached, dict) and cached.get("lastUpdatedAt") == last_updated
+
+
+class CursorAdapter(SourceAdapter):
+    """Index Cursor App composers and Cursor CLI agent chats as one source."""
+
+    name = "cursor"
+
+    def __init__(
+        self,
+        cache_root: Path | None = None,
+        *,
+        chats_root: Path | None = None,
+        projects_root: Path | None = None,
+        state_dbs: list[Path] | None = None,
+    ) -> None:
+        self.cache_root = cache_root or syncanything_home() / "connectors" / "cursor"
+        self.chats_root = chats_root if chats_root is not None else _cursor_cli_chats_root()
+        self.projects_root = projects_root if projects_root is not None else _cursor_projects_root()
+        self.state_dbs = state_dbs
+
+    def discover(self) -> Iterable[Path]:
+        seen_ids: set[str] = set()
+        self._sync_from_databases(seen_ids)
+        self._sync_from_cli_chats(seen_ids)
+        if not self.cache_root.exists():
+            return []
+        cached = list(self.cache_root.glob("composer-*.json")) + list(self.cache_root.glob("cli-*.json"))
+        return sorted(cached)
+
+    def _sync_from_databases(self, seen_ids: set[str]) -> None:
+        db_paths = self.state_dbs if self.state_dbs is not None else _find_state_dbs()
+        for db_path in db_paths:
+            try:
+                self._extract_composers(db_path, seen_ids)
+            except (sqlite3.Error, OSError):
+                continue
+        if not self.cache_root.exists():
+            return
+        for cached in self.cache_root.glob("composer-*.json"):
+            composer_id = cached.stem.split("composer-", 1)[-1]
+            if composer_id not in seen_ids:
+                cached.unlink(missing_ok=True)
+
+    def _extract_composers(self, db_path: Path, seen_ids: set[str]) -> None:
+        connection = sqlite3.connect(f"file:{db_path}?mode=ro", uri=True)
+        connection.row_factory = sqlite3.Row
+        try:
+            rows = connection.execute(
+                "SELECT composerId, lastUpdatedAt, value "
+                "FROM composerHeaders "
+                "WHERE isSubagent = 0 AND composerId != 'empty-state-draft'"
+            ).fetchall()
+            for row in rows:
+                composer_id = row["composerId"]
+                if composer_id in seen_ids:
+                    continue
+                seen_ids.add(composer_id)
+                last_updated = row["lastUpdatedAt"]
+                cache_path = self.cache_root / f"composer-{composer_id}.json"
+                if _cached_matches(cache_path, last_updated):
+                    continue
+                header = json.loads(row["value"]) if row["value"] else {}
+                if not isinstance(header, dict):
+                    header = {}
+                bubbles = connection.execute(
+                    "SELECT value FROM cursorDiskKV WHERE key LIKE ?",
+                    (f"bubbleId:{composer_id}:%",),
+                ).fetchall()
+                bubble_data = []
+                for bubble_row in bubbles:
+                    try:
+                        bubble = json.loads(bubble_row["value"])
+                    except (json.JSONDecodeError, TypeError):
+                        continue
+                    if isinstance(bubble, dict):
+                        bubble_data.append(bubble)
+                if not bubble_data:
+                    if cache_path.exists():
+                        cache_path.unlink(missing_ok=True)
+                    continue
+                snapshot = {
+                    "kind": "app",
+                    "composerId": composer_id,
+                    "name": header.get("name", ""),
+                    "lastUpdatedAt": last_updated,
+                    "createdAt": header.get("createdAt"),
+                    "unifiedMode": header.get("unifiedMode", ""),
+                    "bubbles": bubble_data,
+                }
+                _write_cache(cache_path, snapshot)
+        finally:
+            connection.close()
+
+    def _sync_from_cli_chats(self, seen_ids: set[str]) -> None:
+        cli_ids: set[str] = set()
+        if self.chats_root.exists():
+            for meta_path in sorted(self.chats_root.glob("*/*/meta.json")):
+                session_dir = meta_path.parent
+                session_id = session_dir.name
+                if session_id in seen_ids or session_id in cli_ids:
+                    continue
+                try:
+                    meta = json.loads(meta_path.read_text(encoding="utf-8"))
+                except (OSError, json.JSONDecodeError):
+                    continue
+                if not isinstance(meta, dict) or not meta.get("hasConversation", True):
+                    continue
+                last_updated = meta.get("updatedAtMs") or meta.get("createdAtMs")
+                cache_path = self.cache_root / f"cli-{session_id}.json"
+                if _cached_matches(cache_path, last_updated):
+                    cli_ids.add(session_id)
+                    seen_ids.add(session_id)
+                    continue
+                messages = self._cli_messages(session_id, session_dir)
+                if not messages:
+                    if cache_path.exists():
+                        cache_path.unlink(missing_ok=True)
+                    continue
+                snapshot = {
+                    "kind": "cli",
+                    "sessionId": session_id,
+                    "name": meta.get("title") or "",
+                    "cwd": meta.get("cwd"),
+                    "createdAt": meta.get("createdAtMs"),
+                    "lastUpdatedAt": last_updated,
+                    "messages": messages,
+                }
+                _write_cache(cache_path, snapshot)
+                cli_ids.add(session_id)
+                seen_ids.add(session_id)
+
+        if not self.cache_root.exists():
+            return
+        for cached in self.cache_root.glob("cli-*.json"):
+            session_id = cached.stem.split("cli-", 1)[-1]
+            if session_id not in cli_ids:
+                cached.unlink(missing_ok=True)
+
+    def _cli_messages(self, session_id: str, session_dir: Path) -> list[dict[str, str | None]]:
+        transcript = self._find_cli_transcript(session_id)
+        if transcript is not None:
+            messages = self._messages_from_transcript(transcript)
+            if messages:
+                return messages
+        store_path = session_dir / "store.db"
+        if store_path.exists():
+            return self._messages_from_store(store_path)
+        return []
+
+    def _find_cli_transcript(self, session_id: str) -> Path | None:
+        if not self.projects_root.exists():
+            return None
+        direct = list(self.projects_root.glob(f"*/agent-transcripts/{session_id}/{session_id}.jsonl"))
+        if direct:
+            return direct[0]
+        matches = list(self.projects_root.glob(f"**/agent-transcripts/{session_id}/{session_id}.jsonl"))
+        return matches[0] if matches else None
+
+    def _messages_from_transcript(self, path: Path) -> list[dict[str, str | None]]:
+        messages: list[dict[str, str | None]] = []
+        for record in read_jsonl(path):
+            role = record.get("role")
+            if role not in {"user", "assistant"}:
+                continue
+            payload = record.get("message")
+            content = payload.get("content") if isinstance(payload, dict) else record.get("content")
+            text = visible_text(content)
+            if not text:
+                continue
+            if role == "user":
+                text = _clean_cli_user_text(text)
+            if not text:
+                continue
+            messages.append({"role": role, "text": text, "timestamp": None})
+        return messages
+
+    def _messages_from_store(self, store_path: Path) -> list[dict[str, str | None]]:
+        """Best-effort fallback when agent-transcript JSONL is missing.
+
+        Cursor CLI store.db is content-addressed and partially protobuf-wrapped.
+        Only fully UTF-8 JSON blobs with visible user/assistant text are kept.
+        """
+        messages: list[dict[str, str | None]] = []
+        try:
+            connection = sqlite3.connect(f"file:{store_path}?mode=ro", uri=True)
+        except sqlite3.Error:
+            return []
+        try:
+            rows = connection.execute("SELECT data FROM blobs").fetchall()
+        except sqlite3.Error:
+            connection.close()
+            return []
+        for (data,) in rows:
+            if not isinstance(data, (bytes, bytearray, memoryview)):
+                continue
+            raw = bytes(data)
+            try:
+                text = raw.decode("utf-8")
+            except UnicodeDecodeError:
+                continue
+            text = text.strip()
+            if not text.startswith("{"):
+                continue
+            try:
+                payload = json.loads(text)
+            except json.JSONDecodeError:
+                continue
+            if not isinstance(payload, dict):
+                continue
+            role = payload.get("role")
+            if role not in {"user", "assistant"}:
+                continue
+            body = visible_text(payload.get("content"))
+            if not body:
+                continue
+            if role == "user":
+                body = _clean_cli_user_text(body)
+            if not body:
+                continue
+            # Skip giant system-like user dumps that are not the visible query.
+            if role == "user" and body.lstrip().startswith("<user_info>"):
+                continue
+            messages.append({"role": role, "text": body, "timestamp": None})
+        connection.close()
+        return messages
+
+    def parse(self, path: Path) -> Session | None:
+        try:
+            payload = json.loads(path.read_text(encoding="utf-8"))
+        except (OSError, json.JSONDecodeError):
+            return None
+        if not isinstance(payload, dict):
+            return None
+        kind = payload.get("kind")
+        if kind == "cli" or (
+            "sessionId" in payload and "messages" in payload and "bubbles" not in payload
+        ):
+            return self._parse_cli(path, payload)
+        return self._parse_app(path, payload)
+
+    def _parse_app(self, path: Path, payload: dict[str, Any]) -> Session | None:
+        composer_id = payload.get("composerId", path.stem.split("composer-", 1)[-1])
+        bubbles = payload.get("bubbles", [])
+        if not isinstance(bubbles, list):
+            return None
+
+        timed: list[tuple[str, Message]] = []
+        for bubble in bubbles:
+            if not isinstance(bubble, dict):
+                continue
+            bubble_type = bubble.get("type")
+            if bubble_type == _BUBBLE_TYPE_USER:
+                role = "user"
+            elif bubble_type == _BUBBLE_TYPE_ASSISTANT:
+                role = "assistant"
+            else:
+                continue
+            if bubble.get("capabilityType") is not None:
+                continue
+            text = bubble.get("text", "")
+            if not isinstance(text, str) or not text.strip():
+                continue
+            timestamp = bubble.get("createdAt", "")
+            timed.append((timestamp, Message(role=role, text=text.strip(), timestamp=timestamp or None)))
+
+        timed.sort(key=lambda pair: pair[0])
+        messages = [message for _, message in timed]
+
+        if not messages:
+            return None
+        started_at = _ms_to_iso(payload.get("createdAt")) or (messages[0].timestamp if messages else None)
+        updated_at = _ms_to_iso(payload.get("lastUpdatedAt")) or (messages[-1].timestamp if messages else None)
+        return Session(
+            source=self.name,
+            native_id=str(composer_id),
+            path=path,
+            messages=messages,
+            title=choose_title(messages, payload.get("name") or None),
+            started_at=started_at,
+            updated_at=updated_at,
+            metadata={"cursor_surface": "app"},
+        )
+
+    def _parse_cli(self, path: Path, payload: dict[str, Any]) -> Session | None:
+        session_id = str(payload.get("sessionId") or path.stem.split("cli-", 1)[-1])
+        raw_messages = payload.get("messages", [])
+        if not isinstance(raw_messages, list):
+            return None
+        messages: list[Message] = []
+        for item in raw_messages:
+            if not isinstance(item, dict):
+                continue
+            role = item.get("role")
+            text = item.get("text")
+            if role not in {"user", "assistant"} or not isinstance(text, str) or not text.strip():
+                continue
+            timestamp = item.get("timestamp")
+            messages.append(
+                Message(
+                    role=role,
+                    text=text.strip(),
+                    timestamp=timestamp if isinstance(timestamp, str) else None,
+                )
+            )
+        if not messages:
+            return None
+        cwd = payload.get("cwd")
+        return Session(
+            source=self.name,
+            native_id=session_id,
+            path=path,
+            messages=messages,
+            title=choose_title(messages, payload.get("name") or None),
+            cwd=cwd if isinstance(cwd, str) else None,
+            started_at=_ms_to_iso(payload.get("createdAt")),
+            updated_at=_ms_to_iso(payload.get("lastUpdatedAt")),
+            metadata={"cursor_surface": "cli"},
+        )

{syncanything-0.3.0 → syncanything-0.3.2}/src/syncanything/static/app.js

@@ -26,7 +26,7 @@ const translations = {
     "stats.characters": "总字数",
     "stats.characters.detail": "{words} 个词",
     "stats.tokens": "估算 Token",
-    "stats.tokens.detail": "按中日韩 1.5 字、拉丁 4 字符每 Token 估算",
+    "stats.tokens.detail": "按中日韩 1.5 字 / 拉丁 4 字符估算",
     "stats.storage": "索引占用",
     "stats.storage.detail": "正文 {text}，索引膨胀 {ratio} 倍",
     "stats.books": "相当于",
@@ -54,7 +54,7 @@ const translations = {
     "connections.remove": "移除",
     "connections.site": "站点",
     "connections.site.china": "中国站 · citeanything.cn",
-    "connections.site.international": "国际站 · citeanything.veri-glow.com",
+    "connections.site.international": "国际站 · citeanything.app",
     "connections.site.custom": "自定义",
     "connections.name": "连接名称",
     "connections.base_url": "站点地址",
@@ -97,7 +97,7 @@ const translations = {
     "stats.characters": "Words",
     "stats.characters.detail": "{characters} characters",
     "stats.tokens": "Estimated tokens",
-    "stats.tokens.detail": "Estimated at 1.5 CJK characters and 4 Latin characters per token",
+    "stats.tokens.detail": "Estimated at 1.5 CJK / 4 Latin characters per token",
     "stats.storage": "Index on disk",
     "stats.storage.detail": "{text} of text, {ratio}x index overhead",
     "stats.books": "Equivalent to",
@@ -125,7 +125,7 @@ const translations = {
     "connections.remove": "Remove",
     "connections.site": "Site",
     "connections.site.china": "China · citeanything.cn",
-    "connections.site.international": "International · citeanything.veri-glow.com",
+    "connections.site.international": "International · citeanything.app",
     "connections.site.custom": "Custom",
     "connections.name": "Connection name",
     "connections.base_url": "Site URL",
@@ -173,7 +173,7 @@ const dialog = document.querySelector("#session-dialog");
 const connectionsDialog = document.querySelector("#connections-dialog");
 let searchTimer;
 
-const sourceNames = { claude: "Claude Code", codex: "Codex", kimi: "Kimi Code", pi: "Pi", citeanything: "CiteAnything" };
+const sourceNames = { claude: "Claude Code", codex: "Codex", cursor: "Cursor", kimi: "Kimi Code", pi: "Pi", citeanything: "CiteAnything" };
 
 function t(key, params = {}) {
   const table = translations[state.language] || translations.en;

{syncanything-0.3.0 → syncanything-0.3.2}/src/syncanything/static/index.html

@@ -76,7 +76,7 @@
             <span data-i18n="connections.site">站点</span>
             <select id="connection-site">
               <option value="china" data-i18n="connections.site.china">中国站 · citeanything.cn</option>
-              <option value="international" data-i18n="connections.site.international">国际站 · citeanything.veri-glow.com</option>
+              <option value="international" data-i18n="connections.site.international">国际站 · citeanything.app</option>
               <option value="custom" data-i18n="connections.site.custom">自定义</option>
             </select>
           </label>

{syncanything-0.3.0 → syncanything-0.3.2}/src/syncanything/static/styles.css

@@ -46,6 +46,8 @@ button { cursor: pointer; }
 .brand small { color: var(--muted); font-weight: 500; margin-left: -4px; }
 .status { margin-left: auto; color: var(--muted); font-size: 13px; }
 
+/* A label that breaks across lines makes the toolbar taller than the bar. */
+.quiet-button { white-space: nowrap; }
 .quiet-button, .icon-button {
   border: 1px solid var(--line);
   background: rgba(255,255,255,.8);
@@ -86,22 +88,29 @@ h1 span { color: var(--green); }
 #language-toggle { min-width: 54px; text-align: center; }
 
 .stats-section { margin-bottom: 46px; }
-.stat-grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(160px, 1fr)); gap: 12px; }
+/* Six fixed cards lay out evenly as 3x2; auto-fit would strand one on its own
+   row at common widths. The tracks stay wide enough that a grouped figure never
+   has to break between digits. */
+.stat-grid { display: grid; grid-template-columns: repeat(3, minmax(0, 1fr)); gap: 12px; }
 .stat-card { display: grid; gap: 6px; align-content: start; padding: 16px 18px; background: rgba(255,255,255,.86); border: 1px solid var(--line); border-radius: 14px; }
 .stat-label { color: var(--muted); font-size: 12px; font-weight: 650; }
-.stat-value { font-size: 25px; font-weight: 680; line-height: 1.15; letter-spacing: -.035em; overflow-wrap: anywhere; }
+.stat-value { font-size: 23px; font-weight: 680; line-height: 1.15; letter-spacing: -.035em; }
 .stat-detail { color: var(--muted); font-size: 11px; line-height: 1.5; }
 .stat-note { margin: 14px 0 0; color: var(--muted); font-size: 12px; line-height: 1.65; }
 
 .section-heading { display: flex; align-items: baseline; gap: 12px; margin-bottom: 16px; }
 .section-heading h2 { font-size: 20px; margin: 0; letter-spacing: -.02em; }
 .section-heading span { color: var(--muted); font-size: 13px; }
-.results { display: grid; gap: 12px; }
+/* minmax(0, …) lets a card narrower than its own content shrink instead of
+   widening the track, which a long source path or English date would do. */
+.results { display: grid; grid-template-columns: minmax(0, 1fr); gap: 12px; }
 .result-card { padding: 20px 22px; background: rgba(255,255,255,.86); border: 1px solid var(--line); border-radius: 15px; transition: transform .18s, border-color .18s, box-shadow .18s; outline: none; }
 .result-card:hover, .result-card:focus { transform: translateY(-2px); border-color: #a9dbc8; box-shadow: 0 12px 36px rgba(31,55,45,.07); }
-.card-meta { display: flex; align-items: center; gap: 10px; color: var(--muted); font-size: 12px; }
+.card-meta { display: flex; align-items: center; flex-wrap: wrap; gap: 6px 10px; color: var(--muted); font-size: 12px; }
 .source-badge { display: inline-flex; align-items: center; border-radius: 5px; padding: 4px 7px; color: var(--green-dark); background: var(--green-soft); font-size: 11px; font-weight: 720; text-transform: uppercase; letter-spacing: .05em; }
-.result-card h3 { margin: 12px 0 8px; font-size: 18px; letter-spacing: -.015em; }
+/* A pasted URL in a title has no break opportunity and would otherwise set the
+   card's minimum width, pushing the whole page into horizontal scroll. */
+.result-card h3 { margin: 12px 0 8px; font-size: 18px; letter-spacing: -.015em; overflow-wrap: anywhere; }
 .snippet { margin: 0; color: #55625c; line-height: 1.6; display: -webkit-box; -webkit-line-clamp: 2; -webkit-box-orient: vertical; overflow: hidden; }
 mark { background: #c9f5df; color: inherit; border-radius: 2px; }
 .card-foot { display: flex; align-items: center; margin-top: 14px; gap: 12px; color: var(--muted); font-size: 12px; }
@@ -159,11 +168,16 @@ dialog::backdrop { background: rgba(20, 35, 29, .38); backdrop-filter: blur(4px)
   .topbar { padding: 0 4vw; gap: 10px; }
   .brand small, .status, .search-box kbd { display: none; }
   /* Only the first button takes the free space; the rest sit beside it. */
-  #language-toggle { margin-left: auto; }
+  #language-toggle { margin-left: auto; min-width: 0; }
+  /* Three buttons plus the wordmark do not fit 390px at full size. */
+  .brand span { font-size: 15px; }
+  .quiet-button { padding: 7px 9px; font-size: 12px; }
   .hero { padding-top: 54px; }
   h1 { font-size: 43px; }
-  .stat-grid { grid-template-columns: repeat(auto-fit, minmax(132px, 1fr)); }
+  .stat-grid { grid-template-columns: repeat(2, minmax(0, 1fr)); }
   .stat-value { font-size: 21px; }
+  /* Let the count drop below a heading that has wrapped rather than crowd it. */
+  .section-heading { flex-wrap: wrap; gap: 2px 12px; }
   .card-foot .cwd { max-width: 58vw; }
   .dialog-actions { align-items: flex-start; flex-direction: column; }
 }

{syncanything-0.3.0 → syncanything-0.3.2/src/syncanything.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: syncanything
-Version: 0.3.0
+Version: 0.3.2
 Summary: An agent-native context index across AI products.
 Author: Chizhong Wang
 License-Expression: MIT
@@ -41,7 +41,7 @@ SyncAnything is a local, agent-native index for conversations across AI products
 
 Phase 1 is intentionally read-only:
 
-- discovers local Claude Code, Codex, Kimi Code, and Pi sessions;
+- discovers local Claude Code, Codex, Cursor, Kimi Code, and Pi sessions;
 - connects to CiteAnything as a product-level context source;
 - indexes visible user and assistant text in SQLite FTS5;
 - searches Chinese and English conversation text;
@@ -68,7 +68,7 @@ For a single headless connection:
 
 ```bash
 export SYNCANYTHING_CITEANYTHING_API_KEY="ca_your_context_read_key"
-export CITEANYTHING_BASE_URL="https://citeanything.veri-glow.com"
+export CITEANYTHING_BASE_URL="https://citeanything.app"
 syncanything index
 syncanything serve --no-index
 ```
@@ -216,7 +216,9 @@ Start the stdio server with:
 syncanything mcp
 ```
 
-Example MCP client configuration:
+### Claude Code
+
+Add to `~/.claude/settings.json` or the project `.mcp.json`:
 
 ```json
 {
@@ -229,6 +231,23 @@ Example MCP client configuration:
 }
 ```
 
+### Cursor
+
+Add to `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (per-project):
+
+```json
+{
+  "mcpServers": {
+    "syncanything": {
+      "command": "syncanything",
+      "args": ["mcp"]
+    }
+  }
+}
+```
+
+Restart Cursor after saving. The MCP server appears under **Settings → MCP** when connected.
+
 For a non-default local home or database, keep the database and connection metadata together. If `--db` is supplied and `SYNCANYTHING_HOME` is not set, SyncAnything infers the home directory from the database parent:
 
 ```json
@@ -284,16 +303,18 @@ rather than re-downloaded.
 
 ## Source support
 
-| Source | Location | Phase 1 status |
-|---|---|---|
-| Claude Code | `~/.claude/projects/**/*.jsonl` | Verified locally |
-| Codex | `~/.codex/sessions/**/*.jsonl` | Verified locally |
-| Kimi Code (legacy) | `~/.kimi/sessions/*/*/context.jsonl` | Verified locally |
-| Kimi Code (current) | `~/.kimi-code/sessions/*/*/agents/main/wire.jsonl` | Adapter included |
-| Pi | `~/.pi/agent/sessions/**/*.jsonl` | Official format implemented |
-| CiteAnything | Authenticated Conversation API | Product-level adapter included |
-| OpenCode | SQLite session store | Next adapter |
-| Grok Build | Pending stable local export contract | Next adapter |
+| | Source | Location | Phase 1 status |
+|---|---|---|---|
+| <img src="docs/logos/claudecode-color.svg" width="20" alt="Claude Code"> | Claude Code | `~/.claude/projects/**/*.jsonl` | Verified locally |
+| <img src="docs/logos/codex-color.svg" width="20" alt="Codex"> | Codex | `~/.codex/sessions/**/*.jsonl` | Verified locally |
+| <img src="docs/logos/cursor.svg" width="20" alt="Cursor"> | Cursor App | `state.vscdb` (composerHeaders + cursorDiskKV) | Verified locally |
+| <img src="docs/logos/cursor.svg" width="20" alt="Cursor"> | Cursor CLI | `~/.cursor/chats/*/*/meta.json` + `agent-transcripts` | Verified locally |
+| <img src="docs/logos/kimi-color.svg" width="20" alt="Kimi Code"> | Kimi Code (legacy) | `~/.kimi/sessions/*/*/context.jsonl` | Verified locally |
+| <img src="docs/logos/kimi-color.svg" width="20" alt="Kimi Code"> | Kimi Code (current) | `~/.kimi-code/sessions/*/*/agents/main/wire.jsonl` | Adapter included |
+| <img src="docs/logos/pi.svg" width="20" alt="Pi"> | Pi | `~/.pi/agent/sessions/**/*.jsonl` | Official format implemented |
+| <img src="docs/logos/citeanything.png" width="20" alt="CiteAnything"> | CiteAnything | Authenticated Conversation API | Product-level adapter included |
+| <img src="docs/logos/opencode.svg" width="20" alt="OpenCode"> | OpenCode | SQLite session store | Next adapter |
+| <img src="docs/logos/grok.svg" width="20" alt="Grok Build"> | Grok Build | Pending stable local export contract | Next adapter |
 
 ## Development
 

{syncanything-0.3.0 → syncanything-0.3.2}/src/syncanything.egg-info/SOURCES.txt

@@ -21,6 +21,7 @@ src/syncanything/sources/base.py
 src/syncanything/sources/citeanything.py
 src/syncanything/sources/claude.py
 src/syncanything/sources/codex.py
+src/syncanything/sources/cursor.py
 src/syncanything/sources/kimi.py
 src/syncanything/sources/pi.py
 src/syncanything/static/__init__.py

{syncanything-0.3.0 → syncanything-0.3.2}/tests/test_syncanything.py

@@ -29,6 +29,7 @@ from syncanything.service import SyncAnythingService
 from syncanything.sources.citeanything import CiteAnythingAdapter
 from syncanything.sources.claude import ClaudeAdapter
 from syncanything.sources.codex import CodexAdapter
+from syncanything.sources.cursor import CursorAdapter
 from syncanything.sources.kimi import KimiAdapter
 from syncanything.sources.pi import PiAdapter
 
@@ -300,6 +301,126 @@ class AdapterTests(unittest.TestCase):
             self.assertEqual(pi.id, "pi:p1")
             self.assertEqual(len(pi.messages), 2)
 
+    def test_cursor_indexes_app_and_cli_without_splitting_source(self) -> None:
+        with tempfile.TemporaryDirectory() as directory:
+            root = Path(directory)
+            cache_root = root / "cache"
+            chats_root = root / "chats"
+            projects_root = root / "projects"
+            session_id = "11111111-2222-3333-4444-555555555555"
+            composer_id = "aaaa-bbbb-cccc-dddd"
+            chat_dir = chats_root / "abcdef0123456789abcdef0123456789" / session_id
+            chat_dir.mkdir(parents=True)
+            (chat_dir / "meta.json").write_text(
+                json.dumps(
+                    {
+                        "schemaVersion": 1,
+                        "createdAtMs": 1_700_000_000_000,
+                        "updatedAtMs": 1_700_000_100_000,
+                        "hasConversation": True,
+                        "title": "CLI session about indexing",
+                        "cwd": "/work",
+                    }
+                ),
+                encoding="utf-8",
+            )
+            transcript = (
+                projects_root
+                / "Users-work"
+                / "agent-transcripts"
+                / session_id
+                / f"{session_id}.jsonl"
+            )
+            write_jsonl(
+                transcript,
+                [
+                    {
+                        "role": "user",
+                        "message": {
+                            "content": [
+                                {
+                                    "type": "text",
+                                    "text": (
+                                        "<timestamp>Sunday, Aug 9, 2026</timestamp>\n"
+                                        "<user_query>\n请支持 Cursor CLI 会话索引\n</user_query>"
+                                    ),
+                                }
+                            ]
+                        },
+                    },
+                    {
+                        "role": "assistant",
+                        "message": {
+                            "content": [
+                                {"type": "text", "text": "已接入 Cursor CLI。"},
+                                {"type": "tool_use", "name": "Shell", "input": {"command": "ls"}},
+                            ]
+                        },
+                    },
+                ],
+            )
+
+            db_path = root / "state.vscdb"
+            connection = sqlite3.connect(db_path)
+            connection.execute(
+                "CREATE TABLE composerHeaders ("
+                "composerId TEXT PRIMARY KEY, lastUpdatedAt INTEGER, isSubagent INTEGER, value TEXT)"
+            )
+            connection.execute("CREATE TABLE cursorDiskKV (key TEXT PRIMARY KEY, value TEXT)")
+            connection.execute(
+                "INSERT INTO composerHeaders(composerId, lastUpdatedAt, isSubagent, value) VALUES (?, ?, 0, ?)",
+                (
+                    composer_id,
+                    1_700_000_050_000,
+                    json.dumps({"name": "App composer", "createdAt": 1_700_000_000_000, "unifiedMode": "agent"}),
+                ),
+            )
+            connection.execute(
+                "INSERT INTO cursorDiskKV(key, value) VALUES (?, ?)",
+                (
+                    f"bubbleId:{composer_id}:b1",
+                    json.dumps({"type": 1, "text": "App 窗口里的问题", "createdAt": "2026-08-09T00:00:00Z"}),
+                ),
+            )
+            connection.execute(
+                "INSERT INTO cursorDiskKV(key, value) VALUES (?, ?)",
+                (
+                    f"bubbleId:{composer_id}:b2",
+                    json.dumps({"type": 2, "text": "App 窗口里的回答", "createdAt": "2026-08-09T00:00:01Z"}),
+                ),
+            )
+            connection.commit()
+            connection.close()
+
+            adapter = CursorAdapter(
+                cache_root,
+                chats_root=chats_root,
+                projects_root=projects_root,
+                state_dbs=[db_path],
+            )
+            discovered = list(adapter.discover())
+            self.assertEqual(
+                {path.name for path in discovered},
+                {f"composer-{composer_id}.json", f"cli-{session_id}.json"},
+            )
+
+            app_session = adapter.parse(cache_root / f"composer-{composer_id}.json")
+            cli_session = adapter.parse(cache_root / f"cli-{session_id}.json")
+            assert app_session is not None and cli_session is not None
+            self.assertEqual(app_session.id, f"cursor:{composer_id}")
+            self.assertEqual(cli_session.id, f"cursor:{session_id}")
+            self.assertEqual(app_session.metadata.get("cursor_surface"), "app")
+            self.assertEqual(cli_session.metadata.get("cursor_surface"), "cli")
+            self.assertEqual(
+                [message.text for message in app_session.messages],
+                ["App 窗口里的问题", "App 窗口里的回答"],
+            )
+            self.assertEqual(
+                [message.text for message in cli_session.messages],
+                ["请支持 Cursor CLI 会话索引", "已接入 Cursor CLI。"],
+            )
+            self.assertEqual(cli_session.cwd, "/work")
+
 
 class IndexAndMcpTests(unittest.TestCase):
     def test_count_search_reports_matches_beyond_result_limit(self) -> None:
@@ -696,7 +817,7 @@ class RefreshTests(unittest.TestCase):
                 self.assertIsNone(index.refresh(max_age_seconds=600))
                 self.assertIsNotNone(index.refresh(max_age_seconds=0))
 
-    def test_refresh_skips_remote_adapters_and_keeps_their_sessions(self) -> None:
+    def test_refresh_syncs_remote_adapters_with_throttle(self) -> None:
         class StubRemote(CodexAdapter):
             name = "citeanything"
             is_remote = True
@@ -731,12 +852,15 @@ class RefreshTests(unittest.TestCase):
                 self.assertEqual(len(index.search("远程产品里的会话")), 1)
                 calls_after_full_index = remote.discover_calls
 
+                # force=True always syncs remote adapters.
                 index.refresh(force=True)
-                # The remote source is never contacted by a read-path refresh...
-                self.assertEqual(remote.discover_calls, calls_after_full_index)
-                # ...and its already-indexed sessions survive the local prune.
+                self.assertEqual(remote.discover_calls, calls_after_full_index + 1)
                 self.assertEqual(len(index.search("远程产品里的会话")), 1)
 
+                # A non-forced refresh within the interval skips the remote sync.
+                index.refresh(force=False)
+                self.assertEqual(remote.discover_calls, calls_after_full_index + 1)
+
     def test_index_report_separates_unchanged_from_empty(self) -> None:
         with tempfile.TemporaryDirectory() as directory:
             root = Path(directory)