npm - omnimemory-cli - Versions diffs - 0.1.0 - Mend

omnimemory-cli 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (26) hide show

package/README.md +131 -0
package/bin/omnimemory +5 -0
package/db/schema.sql +78 -0
package/docs/quickstart-10min.md +47 -0
package/omnimemory/__init__.py +2 -0
package/omnimemory/adapters.py +123 -0
package/omnimemory/cli.py +579 -0
package/omnimemory/core.py +826 -0
package/omnimemory/webui.py +419 -0
package/package.json +37 -0
package/scripts/attach_project.sh +25 -0
package/scripts/bootstrap.sh +77 -0
package/scripts/detach_project.sh +21 -0
package/scripts/install.sh +94 -0
package/scripts/uninstall.sh +13 -0
package/scripts/verify_phase_a.sh +52 -0
package/scripts/verify_phase_b.sh +21 -0
package/scripts/verify_phase_c.sh +19 -0
package/scripts/verify_phase_d.sh +28 -0
package/spec/changelog.md +14 -0
package/spec/memory-envelope.schema.json +111 -0
package/spec/memory-event.schema.json +31 -0
package/spec/protocol.md +78 -0
package/templates/project-minimal/.omni-memory-ignore +8 -0
package/templates/project-minimal/.omni-memory-session.md +13 -0
package/templates/project-minimal/.omni-memory.json +10 -0

package/omnimemory/webui.py ADDED Viewed

@@ -0,0 +1,419 @@
+from __future__ import annotations
+import json
+import sqlite3
+import threading
+import time
+from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
+from pathlib import Path
+from typing import Any
+from urllib.parse import parse_qs, urlparse
+from .core import ensure_storage, find_memories, resolve_paths, save_config
+HTML_PAGE = """<!doctype html>
+<html lang="zh-CN">
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <title>OmniMemory WebUI</title>
+  <style>
+    :root { --bg:#f3f4f6; --card:#ffffff; --ink:#0f172a; --muted:#475569; --line:#e2e8f0; --accent:#0f766e; --tab:#e6fffb; }
+    body { margin:0; font-family: 'IBM Plex Sans', 'Helvetica Neue', sans-serif; background: radial-gradient(circle at top right,#ecfeff,#f8fafc 50%,#f3f4f6); color:var(--ink); }
+    .wrap { max-width: 1080px; margin: 22px auto; padding: 0 16px 36px; }
+    .hero { padding: 18px; border:1px solid var(--line); background:var(--card); border-radius: 14px; }
+    h1 { margin: 0 0 6px; font-size: 28px; letter-spacing: .2px; }
+    .small { font-size:12px; color:var(--muted); }
+    .tabs { display:flex; gap:8px; margin-top:14px; flex-wrap:wrap; }
+    .tab-btn { border:1px solid var(--line); background:#fff; color:#0f172a; border-radius: 10px; padding:8px 12px; cursor:pointer; }
+    .tab-btn.active { background:var(--tab); border-color:#99f6e4; color:#115e59; }
+    .panel { display:none; margin-top:14px; }
+    .panel.active { display:block; }
+    .grid { display:grid; grid-template-columns: 1fr 1fr; gap:16px; }
+    .card { border:1px solid var(--line); background:var(--card); border-radius: 14px; padding:16px; box-shadow: 0 4px 16px rgba(15,23,42,.03); }
+    .wide { grid-column: 1 / -1; }
+    label { display:block; font-size:12px; margin-top:8px; color:var(--muted); }
+    input { width:100%; box-sizing:border-box; border:1px solid #cbd5e1; background:#fff; border-radius:10px; padding:9px 10px; margin-top:4px; }
+    button { border:0; background:var(--accent); color:#fff; border-radius:10px; padding:10px 14px; margin-top:10px; cursor:pointer; }
+    .row-btn { display:flex; gap:10px; flex-wrap:wrap; }
+    table { width:100%; border-collapse: collapse; font-size: 14px; }
+    th, td { padding:8px; border-bottom:1px solid var(--line); text-align:left; }
+    .ok { color:#047857; }
+    .err { color:#b91c1c; }
+    .warn { color:#92400e; }
+    @media (max-width: 920px) { .grid { grid-template-columns:1fr; } }
+  </style>
+</head>
+<body>
+  <div class="wrap">
+    <div class="hero">
+      <h1>OmniMemory WebUI</h1>
+      <div class="small">简洁模式：状态与动作 / 配置 / 记忆管理</div>
+      <div id="status" class="small"></div>
+      <div id="daemonState" class="small"></div>
+      <div class="tabs">
+        <button class="tab-btn active" data-tab="statusTab">状态与动作</button>
+        <button class="tab-btn" data-tab="configTab">配置</button>
+        <button class="tab-btn" data-tab="memoryTab">记忆管理</button>
+      </div>
+    </div>
+    <div id="statusTab" class="panel active">
+      <div class="grid">
+        <div class="card">
+          <h3>系统状态</h3>
+          <div id="initState" class="small"></div>
+          <div id="syncHint" class="small" style="margin-top:8px"></div>
+        </div>
+        <div class="card">
+          <h3>动作</h3>
+          <div class="row-btn">
+            <button onclick="runSync('github-status')">检查同步状态</button>
+            <button onclick="runSync('github-bootstrap')">首次接入自动对齐</button>
+            <button onclick="runSync('github-push')">执行 Push</button>
+            <button onclick="runSync('github-pull')">执行 Pull</button>
+          </div>
+          <div class="row-btn">
+            <button onclick="toggleDaemon(true)">开启守护同步</button>
+            <button onclick="toggleDaemon(false)">关闭守护同步</button>
+          </div>
+          <pre id="syncOut" class="small"></pre>
+        </div>
+      </div>
+    </div>
+    <div id="configTab" class="panel">
+      <div class="grid">
+        <div class="card wide">
+        <h3>配置</h3>
+        <form id="cfgForm">
+          <label>Config Path<input name="config_path" readonly /></label>
+          <label>Home<input name="home" /></label>
+          <label>Markdown Path<input name="markdown" /></label>
+          <label>JSONL Path<input name="jsonl" /></label>
+          <label>SQLite Path<input name="sqlite" /></label>
+          <label>Git Remote Name<input name="remote_name" /></label>
+          <label>Git Remote URL<input name="remote_url" placeholder="git@github.com:user/repo.git" /></label>
+          <label>Git Branch<input name="branch" /></label>
+          <button type="submit">保存配置</button>
+        </form>
+      </div>
+      </div>
+    </div>
+    <div id="memoryTab" class="panel">
+      <div class="grid">
+      <div class="card wide">
+        <h3>最近记忆</h3>
+        <div class="small">点击 ID 可看正文</div>
+        <table>
+          <thead><tr><th>ID</th><th>层级</th><th>类型</th><th>摘要</th><th>更新时间</th></tr></thead>
+          <tbody id="memBody"></tbody>
+        </table>
+      </div>
+      <div class="card wide">
+        <h3>记忆正文</h3>
+        <pre id="memView" style="white-space:pre-wrap"></pre>
+      </div>
+      </div>
+    </div>
+  </div>
+  <script>
+    async function jget(url) { const r = await fetch(url); return await r.json(); }
+    async function jpost(url, obj) { const r = await fetch(url,{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify(obj)}); return await r.json(); }
+    async function loadCfg() {
+      const d = await jget('/api/config');
+      const f = document.getElementById('cfgForm');
+      for (const k of ['config_path','home','markdown','jsonl','sqlite','remote_name','remote_url','branch']) {
+        f.elements[k].value = d[k] || '';
+      }
+      const initEl = document.getElementById('initState');
+      const hintEl = document.getElementById('syncHint');
+      if (d.initialized) {
+        initEl.innerHTML = '<span class="ok">配置状态：已初始化</span>';
+        hintEl.textContent = '后台 daemon 会自动准实时同步（可手动关闭）。';
+      } else {
+        initEl.innerHTML = '<span class="warn">配置状态：未初始化（请先保存配置）</span>';
+        hintEl.textContent = '未初始化时不会启动 daemon。保存配置后会自动启用。';
+      }
+    }
+    async function loadMem() {
+      const d = await jget('/api/memories?limit=20');
+      const b = document.getElementById('memBody');
+      b.innerHTML = '';
+      (d.items || []).forEach(x => {
+        const tr = document.createElement('tr');
+        tr.innerHTML = `<td><a href="#" data-id="${x.id}">${x.id.slice(0,10)}...</a></td><td>${x.layer}</td><td>${x.kind}</td><td>${x.summary}</td><td>${x.updated_at}</td>`;
+        tr.querySelector('a').onclick = async (e) => {
+          e.preventDefault();
+          const m = await jget('/api/memory?id=' + encodeURIComponent(x.id));
+          document.getElementById('memView').textContent = m.body || m.error || '';
+        };
+        b.appendChild(tr);
+      });
+    }
+    document.getElementById('cfgForm').onsubmit = async (e) => {
+      e.preventDefault();
+      const f = e.target;
+      const payload = {};
+      for (const k of ['home','markdown','jsonl','sqlite','remote_name','remote_url','branch']) payload[k] = f.elements[k].value;
+      const d = await jpost('/api/config', payload);
+      document.getElementById('status').innerHTML = d.ok ? '<span class="ok">配置已保存</span>' : '<span class="err">保存失败</span>';
+      await loadCfg();
+    };
+    async function runSync(mode) {
+      const d = await jpost('/api/sync', {mode});
+      document.getElementById('syncOut').textContent = JSON.stringify(d, null, 2);
+      await loadMem();
+      await loadDaemon();
+    }
+    async function loadDaemon() {
+      const d = await jget('/api/daemon');
+      document.getElementById('daemonState').textContent = 'Daemon: ' + (d.running ? 'running' : 'stopped') + ', enabled=' + d.enabled + ', initialized=' + d.initialized;
+    }
+    async function toggleDaemon(enabled) {
+      await jpost('/api/daemon/toggle', {enabled});
+      await loadDaemon();
+    }
+    function bindTabs() {
+      const btns = document.querySelectorAll('.tab-btn');
+      btns.forEach(btn => {
+        btn.onclick = () => {
+          btns.forEach(x => x.classList.remove('active'));
+          btn.classList.add('active');
+          document.querySelectorAll('.panel').forEach(p => p.classList.remove('active'));
+          document.getElementById(btn.dataset.tab).classList.add('active');
+        };
+      });
+    }
+    bindTabs();
+    loadCfg();
+    loadMem();
+    loadDaemon();
+  </script>
+</body>
+</html>
+"""
+def _cfg_to_ui(cfg: dict[str, Any], cfg_path: Path) -> dict[str, Any]:
+    storage = cfg.get("storage", {})
+    gh = cfg.get("sync", {}).get("github", {})
+    return {
+        "ok": True,
+        "initialized": cfg_path.exists(),
+        "config_path": str(cfg_path),
+        "home": cfg.get("home", ""),
+        "markdown": storage.get("markdown", ""),
+        "jsonl": storage.get("jsonl", ""),
+        "sqlite": storage.get("sqlite", ""),
+        "remote_name": gh.get("remote_name", "origin"),
+        "remote_url": gh.get("remote_url", ""),
+        "branch": gh.get("branch", "main"),
+    }
+def run_webui(
+    *,
+    host: str,
+    port: int,
+    cfg: dict[str, Any],
+    cfg_path: Path,
+    schema_sql_path: Path,
+    sync_runner,
+    daemon_runner=None,
+    enable_daemon: bool = True,
+    daemon_scan_interval: int = 8,
+    daemon_pull_interval: int = 30,
+) -> None:
+    paths = resolve_paths(cfg)
+    ensure_storage(paths, schema_sql_path)
+    daemon_state: dict[str, Any] = {
+        "initialized": cfg_path.exists(),
+        "enabled": bool(enable_daemon and cfg_path.exists()),
+        "manually_disabled": False,
+        "running": False,
+        "last_result": {},
+        "scan_interval": daemon_scan_interval,
+        "pull_interval": daemon_pull_interval,
+    }
+    stop_event = threading.Event()
+    def daemon_loop() -> None:
+        if daemon_runner is None:
+            return
+        daemon_state["running"] = True
+        while not stop_event.is_set():
+            if not daemon_state.get("initialized", False):
+                time.sleep(1)
+                continue
+            if not daemon_state.get("enabled", True):
+                time.sleep(1)
+                continue
+            try:
+                gh = cfg.get("sync", {}).get("github", {})
+                result = daemon_runner(
+                    paths=paths,
+                    schema_sql_path=schema_sql_path,
+                    remote_name=gh.get("remote_name", "origin"),
+                    branch=gh.get("branch", "main"),
+                    remote_url=gh.get("remote_url"),
+                    scan_interval=daemon_scan_interval,
+                    pull_interval=daemon_pull_interval,
+                    once=True,
+                )
+                daemon_state["last_result"] = result
+            except Exception as exc:  # pragma: no cover
+                daemon_state["last_result"] = {"ok": False, "error": str(exc)}
+            time.sleep(max(1, daemon_scan_interval))
+        daemon_state["running"] = False
+    daemon_thread: threading.Thread | None = None
+    if enable_daemon and daemon_runner is not None:
+        daemon_thread = threading.Thread(target=daemon_loop, name="omnimemory-daemon", daemon=True)
+        daemon_thread.start()
+    class Handler(BaseHTTPRequestHandler):
+        def _send_json(self, data: dict[str, Any], code: int = 200) -> None:
+            b = json.dumps(data, ensure_ascii=False).encode("utf-8")
+            self.send_response(code)
+            self.send_header("Content-Type", "application/json; charset=utf-8")
+            self.send_header("Content-Length", str(len(b)))
+            self.end_headers()
+            self.wfile.write(b)
+        def _send_html(self, html: str, code: int = 200) -> None:
+            b = html.encode("utf-8")
+            self.send_response(code)
+            self.send_header("Content-Type", "text/html; charset=utf-8")
+            self.send_header("Content-Length", str(len(b)))
+            self.end_headers()
+            self.wfile.write(b)
+        def do_GET(self) -> None:  # noqa: N802
+            parsed = urlparse(self.path)
+            if parsed.path == "/":
+                self._send_html(HTML_PAGE)
+                return
+            if parsed.path == "/api/config":
+                self._send_json(_cfg_to_ui(cfg, cfg_path))
+                return
+            if parsed.path == "/api/daemon":
+                self._send_json({"ok": True, **daemon_state})
+                return
+            if parsed.path == "/api/memories":
+                q = parse_qs(parsed.query)
+                limit = int(q.get("limit", ["20"])[0])
+                items = find_memories(paths, schema_sql_path, query="", layer=None, limit=limit)
+                self._send_json({"ok": True, "items": items})
+                return
+            if parsed.path == "/api/memory":
+                q = parse_qs(parsed.query)
+                mem_id = q.get("id", [""])[0]
+                if not mem_id:
+                    self._send_json({"ok": False, "error": "missing id"}, 400)
+                    return
+                try:
+                    with sqlite3.connect(paths.sqlite_path) as conn:
+                        row = conn.execute(
+                            "SELECT body_md_path FROM memories WHERE id = ?",
+                            (mem_id,),
+                        ).fetchone()
+                    if not row:
+                        self._send_json({"ok": False, "error": "not found"}, 404)
+                        return
+                    md_path = paths.markdown_root / row[0]
+                    self._send_json({"ok": True, "body": md_path.read_text(encoding="utf-8")})
+                except Exception as exc:  # pragma: no cover
+                    self._send_json({"ok": False, "error": str(exc)}, 500)
+                return
+            self._send_json({"ok": False, "error": "not found"}, 404)
+        def do_POST(self) -> None:  # noqa: N802
+            parsed = urlparse(self.path)
+            length = int(self.headers.get("Content-Length", "0") or "0")
+            raw = self.rfile.read(length) if length else b"{}"
+            data = json.loads(raw.decode("utf-8") or "{}")
+            if parsed.path == "/api/config":
+                cfg["home"] = data.get("home", cfg.get("home", ""))
+                cfg.setdefault("storage", {})
+                cfg["storage"]["markdown"] = data.get("markdown", cfg["storage"].get("markdown", ""))
+                cfg["storage"]["jsonl"] = data.get("jsonl", cfg["storage"].get("jsonl", ""))
+                cfg["storage"]["sqlite"] = data.get("sqlite", cfg["storage"].get("sqlite", ""))
+                cfg.setdefault("sync", {}).setdefault("github", {})
+                cfg["sync"]["github"]["remote_name"] = data.get("remote_name", "origin")
+                cfg["sync"]["github"]["remote_url"] = data.get("remote_url", "")
+                cfg["sync"]["github"]["branch"] = data.get("branch", "main")
+                try:
+                    save_config(cfg_path, cfg)
+                    # Refresh resolved path pointers after config update.
+                    nonlocal paths
+                    paths = resolve_paths(cfg)
+                    ensure_storage(paths, schema_sql_path)
+                    was_initialized = daemon_state.get("initialized", False)
+                    daemon_state["initialized"] = True
+                    if not was_initialized and enable_daemon:
+                        daemon_state["enabled"] = not daemon_state.get("manually_disabled", False)
+                    self._send_json({"ok": True})
+                except Exception as exc:  # pragma: no cover
+                    self._send_json({"ok": False, "error": str(exc)}, 500)
+                return
+            if parsed.path == "/api/sync":
+                if not daemon_state.get("initialized", False):
+                    self._send_json({"ok": False, "error": "config not initialized; save config first"}, 400)
+                    return
+                mode = data.get("mode", "github-status")
+                gh = cfg.get("sync", {}).get("github", {})
+                try:
+                    out = sync_runner(
+                        paths,
+                        schema_sql_path,
+                        mode,
+                        remote_name=gh.get("remote_name", "origin"),
+                        branch=gh.get("branch", "main"),
+                        remote_url=gh.get("remote_url"),
+                        commit_message="chore(memory): sync from webui",
+                    )
+                    self._send_json(out)
+                except Exception as exc:  # pragma: no cover
+                    self._send_json({"ok": False, "error": str(exc)}, 500)
+                return
+            if parsed.path == "/api/daemon/toggle":
+                desired = bool(data.get("enabled", True))
+                daemon_state["manually_disabled"] = not desired
+                daemon_state["enabled"] = bool(desired and daemon_state.get("initialized", False))
+                self._send_json(
+                    {
+                        "ok": True,
+                        "enabled": daemon_state["enabled"],
+                        "initialized": daemon_state["initialized"],
+                        "running": daemon_state["running"],
+                        "last_result": daemon_state.get("last_result", {}),
+                    }
+                )
+                return
+            self._send_json({"ok": False, "error": "not found"}, 404)
+    server = ThreadingHTTPServer((host, port), Handler)
+    print(f"WebUI running on http://{host}:{port} (daemon={'on' if enable_daemon else 'off'})")
+    try:
+        server.serve_forever()
+    finally:
+        stop_event.set()
+        if daemon_thread is not None:
+            daemon_thread.join(timeout=1.5)

package/package.json ADDED Viewed

@@ -0,0 +1,37 @@
+{
+  "name": "omnimemory-cli",
+  "version": "0.1.0",
+  "private": false,
+  "description": "OmniMemory CLI and bootstrap runner",
+  "license": "MIT",
+  "bin": {
+    "omnimemory": "bin/omnimemory"
+  },
+  "files": [
+    "bin",
+    "omnimemory",
+    "scripts",
+    "templates",
+    "db",
+    "spec",
+    "README.md",
+    "docs/quickstart-10min.md"
+  ],
+  "scripts": {
+    "prepack": "find omnimemory -name '__pycache__' -type d -prune -exec rm -rf {} +",
+    "start": "./bin/omnimemory start --host 127.0.0.1 --port 8765",
+    "verify": "bash scripts/verify_phase_d.sh",
+    "pack:check": "npm pack --dry-run"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/YOUR_ORG/omnimemory.git"
+  },
+  "homepage": "https://github.com/YOUR_ORG/omnimemory#readme",
+  "bugs": {
+    "url": "https://github.com/YOUR_ORG/omnimemory/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}

package/scripts/attach_project.sh ADDED Viewed

@@ -0,0 +1,25 @@
+#!/usr/bin/env bash
+set -euo pipefail
+if [[ $# -lt 2 ]]; then
+  echo "Usage: bash scripts/attach_project.sh <project_path> <project_id>"
+  exit 1
+fi
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+PROJECT_PATH="$1"
+PROJECT_ID="$2"
+if [[ ! -d "$PROJECT_PATH" ]]; then
+  echo "Project path not found: $PROJECT_PATH"
+  exit 1
+fi
+cp -f "$ROOT_DIR/templates/project-minimal/.omni-memory.json" "$PROJECT_PATH/.omni-memory.json"
+cp -f "$ROOT_DIR/templates/project-minimal/.omni-memory-session.md" "$PROJECT_PATH/.omni-memory-session.md"
+cp -f "$ROOT_DIR/templates/project-minimal/.omni-memory-ignore" "$PROJECT_PATH/.omni-memory-ignore"
+sed -i.bak "s/replace-with-project-id/$PROJECT_ID/g" "$PROJECT_PATH/.omni-memory.json"
+rm -f "$PROJECT_PATH/.omni-memory.json.bak"
+echo "Attached OmniMemory to: $PROJECT_PATH (project_id=$PROJECT_ID)"

package/scripts/bootstrap.sh ADDED Viewed

@@ -0,0 +1,77 @@
+#!/usr/bin/env bash
+set -euo pipefail
+# One-command bootstrap for new device / new account.
+# Example:
+#   bash scripts/bootstrap.sh --repo git@github.com:YOUR_USER/omnimemory.git
+#   bash scripts/bootstrap.sh --repo https://github.com/YOUR_USER/omnimemory.git --attach ~/code/myproj --project-id myproj
+TARGET_HOME="${OMNIMEMORY_HOME:-$HOME/.omnimemory}"
+APP_DIR="$TARGET_HOME/app"
+REPO_URL=""
+BRANCH="main"
+REMOTE_NAME="origin"
+REMOTE_URL=""
+ATTACH_PATH=""
+PROJECT_ID=""
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --repo)
+      REPO_URL="$2"
+      shift 2
+      ;;
+    --branch)
+      BRANCH="$2"
+      shift 2
+      ;;
+    --remote-name)
+      REMOTE_NAME="$2"
+      shift 2
+      ;;
+    --remote-url)
+      REMOTE_URL="$2"
+      shift 2
+      ;;
+    --attach)
+      ATTACH_PATH="$2"
+      shift 2
+      ;;
+    --project-id)
+      PROJECT_ID="$2"
+      shift 2
+      ;;
+    *)
+      echo "Unknown arg: $1"
+      exit 1
+      ;;
+  esac
+done
+if [[ -z "$REPO_URL" ]]; then
+  echo "Usage: bash scripts/bootstrap.sh --repo <git_repo_url> [--branch main] [--remote-url <memory_git_url>] [--attach <project_path> --project-id <id>]"
+  exit 1
+fi
+mkdir -p "$TARGET_HOME"
+if [[ -d "$APP_DIR/.git" ]]; then
+  git -C "$APP_DIR" fetch --all --prune
+  git -C "$APP_DIR" checkout "$BRANCH"
+  git -C "$APP_DIR" pull --rebase
+else
+  git clone --branch "$BRANCH" "$REPO_URL" "$APP_DIR"
+fi
+cd "$APP_DIR"
+bash scripts/install.sh --remote-name "$REMOTE_NAME" --branch "$BRANCH" ${REMOTE_URL:+--remote-url "$REMOTE_URL"}
+if [[ -n "$ATTACH_PATH" ]]; then
+  if [[ -z "$PROJECT_ID" ]]; then
+    PROJECT_ID="$(basename "$ATTACH_PATH")"
+  fi
+  bash scripts/attach_project.sh "$ATTACH_PATH" "$PROJECT_ID"
+fi
+echo "Bootstrap done."
+echo "Run: $TARGET_HOME/bin/omnimemory start --host 127.0.0.1 --port 8765"

package/scripts/detach_project.sh ADDED Viewed

@@ -0,0 +1,21 @@
+#!/usr/bin/env bash
+set -euo pipefail
+if [[ $# -lt 1 ]]; then
+  echo "Usage: bash scripts/detach_project.sh <project_path>"
+  exit 1
+fi
+PROJECT_PATH="$1"
+if [[ ! -d "$PROJECT_PATH" ]]; then
+  echo "Project path not found: $PROJECT_PATH"
+  exit 1
+fi
+rm -f "$PROJECT_PATH/.omni-memory.json" \
+      "$PROJECT_PATH/.omni-memory-session.md" \
+      "$PROJECT_PATH/.omni-memory-ignore" \
+      "$PROJECT_PATH/.omni-memory-hooks.sh"
+echo "Detached OmniMemory from: $PROJECT_PATH"

package/scripts/install.sh ADDED Viewed

@@ -0,0 +1,94 @@
+#!/usr/bin/env bash
+set -euo pipefail
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+TARGET_HOME="${OMNIMEMORY_HOME:-$HOME/.omnimemory}"
+WIZARD=0
+REMOTE_NAME="origin"
+BRANCH="main"
+REMOTE_URL=""
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --wizard)
+      WIZARD=1
+      shift
+      ;;
+    --remote-name)
+      REMOTE_NAME="$2"
+      shift 2
+      ;;
+    --branch)
+      BRANCH="$2"
+      shift 2
+      ;;
+    --remote-url)
+      REMOTE_URL="$2"
+      shift 2
+      ;;
+    *)
+      echo "Unknown arg: $1"
+      exit 1
+      ;;
+  esac
+done
+if [[ "$WIZARD" -eq 1 ]]; then
+  echo "[OmniMemory Install Wizard]"
+  read -r -p "Install home [$TARGET_HOME]: " input_home
+  TARGET_HOME="${input_home:-$TARGET_HOME}"
+  read -r -p "Git remote name [$REMOTE_NAME]: " input_remote_name
+  REMOTE_NAME="${input_remote_name:-$REMOTE_NAME}"
+  read -r -p "Git branch [$BRANCH]: " input_branch
+  BRANCH="${input_branch:-$BRANCH}"
+  read -r -p "Git remote url (optional, e.g. git@github.com:user/repo.git): " input_remote_url
+  REMOTE_URL="${input_remote_url:-$REMOTE_URL}"
+fi
+mkdir -p "$TARGET_HOME"
+mkdir -p "$TARGET_HOME/data/markdown"/{instant,short,long,archive}
+mkdir -p "$TARGET_HOME/data/jsonl"
+mkdir -p "$TARGET_HOME/spec" "$TARGET_HOME/db" "$TARGET_HOME/docs"
+mkdir -p "$TARGET_HOME/bin" "$TARGET_HOME/lib"
+cp -f "$ROOT_DIR/spec/"*.json "$TARGET_HOME/spec/"
+cp -f "$ROOT_DIR/db/schema.sql" "$TARGET_HOME/db/schema.sql"
+cp -f "$ROOT_DIR/docs/architecture.md" "$TARGET_HOME/docs/architecture.md"
+rm -rf "$TARGET_HOME/lib/omnimemory"
+cp -R "$ROOT_DIR/omnimemory" "$TARGET_HOME/lib/omnimemory"
+cat > "$TARGET_HOME/bin/omnimemory" <<SH
+#!/usr/bin/env bash
+set -euo pipefail
+export OMNIMEMORY_HOME="$TARGET_HOME"
+PYTHONPATH="$TARGET_HOME/lib\${PYTHONPATH:+:\$PYTHONPATH}" exec python3 -m omnimemory.cli "\$@"
+SH
+chmod +x "$TARGET_HOME/bin/omnimemory"
+cat > "$TARGET_HOME/omnimemory.config.json" <<JSON
+{
+  "version": "0.1.0",
+  "home": "$TARGET_HOME",
+  "storage": {
+    "markdown": "$TARGET_HOME/data/markdown",
+    "jsonl": "$TARGET_HOME/data/jsonl",
+    "sqlite": "$TARGET_HOME/data/omnimemory.db"
+  },
+  "sync": {
+    "github": {
+      "remote_name": "$REMOTE_NAME",
+      "remote_url": "$REMOTE_URL",
+      "branch": "$BRANCH"
+    }
+  }
+}
+JSON
+echo "Installed OmniMemory skeleton at: $TARGET_HOME"
+echo "CLI path: $TARGET_HOME/bin/omnimemory"
+echo "Config path: $TARGET_HOME/omnimemory.config.json"
+echo "Start App: $TARGET_HOME/bin/omnimemory start --host 127.0.0.1 --port 8765"