elesync 1.2.0__tar.gz → 1.3.0__tar.gz

{elesync-1.2.0 → elesync-1.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: elesync
-Version: 1.2.0
+Version: 1.3.0
 Summary: Local-first, MCP-native unified memory vault — your AI memory as files you own, shared across every model.
 Author: Alphanymous
 License: MIT
@@ -56,6 +56,7 @@ Dynamic: license-file
 [![CI](https://github.com/darknodebros/EleSync/actions/workflows/ci.yml/badge.svg)](https://github.com/darknodebros/EleSync/actions/workflows/ci.yml)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 [![MCP](https://img.shields.io/badge/MCP-native-8A2BE2.svg)](https://modelcontextprotocol.io)
+[![Buy Me A Coffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-ffdd00?style=flat&logo=buy-me-a-coffee&logoColor=black)](https://buymeacoffee.com/Darknodebros)
 
 <!-- mcp-name: io.github.darknodebros/elesync -->
 
@@ -84,7 +85,7 @@ pip install "elesync[watch]"
 ele watch --autostart        # runs in the background from now on
 ```
 
-**Stable at v1.2** — a 134-test suite, CI across Python 3.10–3.14 (including a dev-extras job
+**Stable at v1.3** — a 179-test suite, CI across Python 3.10–3.14 (including a dev-extras job
 covering encryption and real-model semantic recall) plus ruff lint/format and mypy type-checking,
 and a public surface (CLI commands, MCP tools, vault layout, export format) you can build on
 without breakage inside 1.x. See the [CHANGELOG](CHANGELOG.md) for the full history.
@@ -441,6 +442,34 @@ exposed nothing without it. The same XSalsa20-Poly1305 + argon2id encryption use
 > automatically between the USB vault and your main vault — use `ele export` + `ele import` to
 > move memories between them.
 
+## Local web UI
+
+No terminal needed once EleSync is installed — `ele web` opens a clean browser-based
+vault explorer:
+
+```bash
+ele web                 # opens http://127.0.0.1:7477 in your browser
+ele web --port 8080     # custom port
+ele web --no-browser    # start server without auto-opening browser
+```
+
+**What you get:**
+
+| Tab | What it does |
+|---|---|
+| **Dashboard** | Total memories, AI source breakdown, FTS / embedding status |
+| **Browse** | Paginated list with live filter, source & type dropdowns |
+| **Search** | Instant full-text search across all memories |
+| **Add Memory** | Manually add a memory (content, source, type, tags) |
+| **Import** | Drag-and-drop a ChatGPT / Claude / Gemini / Grok export JSON |
+
+Click any memory to open a slide-in editor — update content, type, tags, or delete it.
+
+**Zero extra dependencies** — pure Python stdlib `http.server`. Works with encrypted
+vaults (prompts for passphrase at startup). Binds to `127.0.0.1` only.
+
+---
+
 ## Sync across devices
 
 Your vault is **just a folder** (`notes/*.md` + a small `vault.json`), so sync it however you

{elesync-1.2.0 → elesync-1.3.0}/README.md

@@ -16,6 +16,7 @@
 [![CI](https://github.com/darknodebros/EleSync/actions/workflows/ci.yml/badge.svg)](https://github.com/darknodebros/EleSync/actions/workflows/ci.yml)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 [![MCP](https://img.shields.io/badge/MCP-native-8A2BE2.svg)](https://modelcontextprotocol.io)
+[![Buy Me A Coffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-ffdd00?style=flat&logo=buy-me-a-coffee&logoColor=black)](https://buymeacoffee.com/Darknodebros)
 
 <!-- mcp-name: io.github.darknodebros/elesync -->
 
@@ -44,7 +45,7 @@ pip install "elesync[watch]"
 ele watch --autostart        # runs in the background from now on
 ```
 
-**Stable at v1.2** — a 134-test suite, CI across Python 3.10–3.14 (including a dev-extras job
+**Stable at v1.3** — a 179-test suite, CI across Python 3.10–3.14 (including a dev-extras job
 covering encryption and real-model semantic recall) plus ruff lint/format and mypy type-checking,
 and a public surface (CLI commands, MCP tools, vault layout, export format) you can build on
 without breakage inside 1.x. See the [CHANGELOG](CHANGELOG.md) for the full history.
@@ -401,6 +402,34 @@ exposed nothing without it. The same XSalsa20-Poly1305 + argon2id encryption use
 > automatically between the USB vault and your main vault — use `ele export` + `ele import` to
 > move memories between them.
 
+## Local web UI
+
+No terminal needed once EleSync is installed — `ele web` opens a clean browser-based
+vault explorer:
+
+```bash
+ele web                 # opens http://127.0.0.1:7477 in your browser
+ele web --port 8080     # custom port
+ele web --no-browser    # start server without auto-opening browser
+```
+
+**What you get:**
+
+| Tab | What it does |
+|---|---|
+| **Dashboard** | Total memories, AI source breakdown, FTS / embedding status |
+| **Browse** | Paginated list with live filter, source & type dropdowns |
+| **Search** | Instant full-text search across all memories |
+| **Add Memory** | Manually add a memory (content, source, type, tags) |
+| **Import** | Drag-and-drop a ChatGPT / Claude / Gemini / Grok export JSON |
+
+Click any memory to open a slide-in editor — update content, type, tags, or delete it.
+
+**Zero extra dependencies** — pure Python stdlib `http.server`. Works with encrypted
+vaults (prompts for passphrase at startup). Binds to `127.0.0.1` only.
+
+---
+
 ## Sync across devices
 
 Your vault is **just a folder** (`notes/*.md` + a small `vault.json`), so sync it however you

{elesync-1.2.0 → elesync-1.3.0}/elesync/__init__.py

@@ -9,4 +9,4 @@ from .service import MemoryService
 from .store import MemoryStore
 
 __all__ = ["MemoryItem", "MEMORY_TYPES", "MemoryStore", "MemoryService", "normalize"]
-__version__ = "1.2.0"
+__version__ = "1.3.0"

{elesync-1.2.0 → elesync-1.3.0}/elesync/cli.py

@@ -392,6 +392,17 @@ def cmd_serve(args) -> int:
     return 0
 
 
+def cmd_web(args) -> int:
+    from .web import serve
+
+    serve(
+        vault_dir=getattr(args, "vault", None),
+        port=getattr(args, "port", 7477),
+        open_browser=not getattr(args, "no_browser", False),
+    )
+    return 0
+
+
 def _vault_path(args) -> str:
     return args.vault or os.environ.get("ELESYNC_DIR", "~/EleSyncVault")
 
@@ -770,6 +781,12 @@ def build_parser() -> argparse.ArgumentParser:
     pusb_eject.add_argument("drive", help="Path to the USB drive")
     pusb_eject.set_defaults(usb_func=cmd_usb_eject)
 
+    # ── web UI ───────────────────────────────────────────────────────────
+    pweb = sub.add_parser("web", help="Open the local web UI in your browser")
+    pweb.add_argument("--port", type=int, default=7477, help="Port to listen on (default: 7477)")
+    pweb.add_argument("--no-browser", action="store_true", help="Don't auto-open the browser")
+    pweb.set_defaults(func=cmd_web)
+
     psum = sub.add_parser(
         "summary",
         help="Show a human-readable digest of everything in your vault",

{elesync-1.2.0 → elesync-1.3.0}/elesync/usb.py

@@ -49,6 +49,22 @@ import subprocess
 import sys
 from pathlib import Path
 
+# Module-level references so tests can patch elesync.usb.crypto / MemoryStore / onboarding
+try:
+    from . import crypto  # type: ignore[attr-defined]
+except Exception:  # pragma: no cover
+    crypto = None  # type: ignore[assignment]
+
+try:
+    from .store import MemoryStore  # type: ignore[attr-defined]
+except Exception:  # pragma: no cover
+    MemoryStore = None  # type: ignore[assignment]
+
+try:
+    from . import onboarding  # type: ignore[attr-defined]
+except Exception:  # pragma: no cover
+    onboarding = None  # type: ignore[assignment]
+
 # ---------------------------------------------------------------------------
 # Drive detection
 # ---------------------------------------------------------------------------
@@ -199,10 +215,7 @@ def install(drive: str | Path, passphrase: str, label: str = "USB") -> dict:
 
     Returns a result dict with the paths created.
     """
-    from . import crypto
-    from .store import MemoryStore
-
-    if not crypto.available():
+    if crypto is None or not crypto.available():
         raise RuntimeError(
             'USB vaults are always encrypted. '
             'Run:  pip install "elesync[encryption]"  first.'
@@ -252,8 +265,6 @@ def attach(drive: str | Path, passphrase: str, name: str = "elesync-usb") -> dic
 
     Returns the result dict from `onboarding.wire_client_config`.
     """
-    from . import crypto, onboarding
-
     drive = Path(drive)
     vp = vault_path(drive)
 
@@ -303,8 +314,6 @@ def detach(drive: str | Path, name: str = "elesync-usb") -> dict:
     Call this before physically unplugging the drive so Claude won't try to
     reconnect to a missing vault on next launch.
     """
-    from . import onboarding
-
     cfg_path = onboarding.default_client_config_path()
     if not cfg_path.exists():
         return {"removed": False, "reason": "Claude Desktop config not found"}
@@ -356,7 +365,7 @@ def status(drive: str | Path) -> dict:
     if not result["vault_present"]:
         return result
 
-    result["encrypted"] = crypto.is_encrypted(vp)
+    result["encrypted"] = (crypto is not None and crypto.is_encrypted(vp))
     result["note_count"] = len(list((vp / "notes").glob("*.md*")))
     return result
 
@@ -404,8 +413,6 @@ def eject(drive: str | Path) -> str:
 def _validate_key(vault_dir: Path, key: bytes) -> None:
     """Raise ValueError if the key cannot decrypt an existing note.
     If there are no notes yet (empty vault), the key is accepted as valid."""
-    from . import crypto
-
     encs = sorted((vault_dir / "notes").glob("*.md.enc"))
     if not encs:
         return  # empty vault — nothing to validate against, trust it