agent-memory-git 0.1.0__tar.gz → 0.1.1__tar.gz

{agent_memory_git-0.1.0 → agent_memory_git-0.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-memory-git
-Version: 0.1.0
+Version: 0.1.1
 Summary: Shared, git-backed memory for Claude Code and Codex.
 Keywords: claude-code,codex,memory,agents,git
 Author: Shichao Song
@@ -30,22 +30,20 @@ you gave Codex is there the next time Claude Code starts, on any machine that pu
 repository. This repository holds only the code; the memories live in a separate data
 repository.
 
-![mem ui listing memories, with one open on the right](docs/mem-ui.png)
+![mem ui listing memories, with one open on the right](https://raw.githubusercontent.com/Ki-Seki/agent-memory/main/docs/mem-ui.png)
 
 <sub>`mem ui` on the [demo data repository](https://github.com/Ki-Seki/agent-memory-data-demo).</sub>
 
 ## Try it without installing
 
 ```bash
-git clone https://github.com/Ki-Seki/agent-memory
 git clone https://github.com/Ki-Seki/agent-memory-data-demo
-cd agent-memory
-AGENT_MEMORY_DATA=../agent-memory-data-demo bin/mem ui --keywords-only
+AGENT_MEMORY_DATA=agent-memory-data-demo uvx --from "agent-memory-git[ui]" mem ui --keywords-only
 ```
 
-`AGENT_MEMORY_DATA` points `mem` at the demo repository, so nothing is installed and no hooks
-change. The page needs `numpy`. `--keywords-only` skips the optional embedding model; leave it
-out after `mem ui --fetch-model` to also search by meaning.
+`uvx` runs `mem` from a throwaway environment and `AGENT_MEMORY_DATA` points it at the demo
+repository, so nothing is installed and no hooks change. `--keywords-only` skips the optional
+embedding model; leave it out after `mem ui --fetch-model` to also search by meaning.
 
 ## How it works
 
@@ -99,7 +97,7 @@ protocol copies; `mem doctor` says when they are out of date.
 | `~/.codex/hooks.json` | the same three hooks |
 | `~/.codex/config.toml` | `memories.generate_memories = false`, `memories.use_memories = false`, data repository added to `sandbox_workspace_write.writable_roots` |
 | `~/.codex/AGENTS.md` | a marked block with the protocol |
-| `~/.local/bin/mem` | symlink to `mem`, only if that file does not exist yet (`uv tool install` already puts one there) |
+| `~/.zshrc` or `~/.bashrc` | a marked block putting `~/.local/bin`, where uv installs `mem`, on PATH, only if a new login shell lacks it |
 
 Codex asks you to trust new hooks once: open `/hooks` in Codex and enable the three
 agent-memory hooks.
@@ -161,9 +159,14 @@ uv run pytest
 uv run ruff check .
 ```
 
-From a checkout, `bin/mem` (or `uv run mem`) runs the code in place; `mem install` from there
-points the hooks at that checkout, so edits take effect in the next session.
-`uv tool install --editable .` does the same with `mem` on PATH.
+`uv run mem ...` runs the working copy without touching the installed one. To have every
+session use the working copy, install it in place of the release and rewire the hooks; go back
+the same way:
+
+```bash
+uv tool install --force --editable ".[ui]" && mem install    # the checkout, live
+uv tool install --force "agent-memory-git[ui]" && mem install  # the release again
+```
 
 To release, run `uv run scripts/release.py prepare patch` (or `minor`, `major`) to open a
 version PR. After it is merged, `uv run scripts/release.py publish <PR_NUMBER>` creates the GitHub

{agent_memory_git-0.1.0 → agent_memory_git-0.1.1}/README.md

@@ -10,22 +10,20 @@ you gave Codex is there the next time Claude Code starts, on any machine that pu
 repository. This repository holds only the code; the memories live in a separate data
 repository.
 
-![mem ui listing memories, with one open on the right](docs/mem-ui.png)
+![mem ui listing memories, with one open on the right](https://raw.githubusercontent.com/Ki-Seki/agent-memory/main/docs/mem-ui.png)
 
 <sub>`mem ui` on the [demo data repository](https://github.com/Ki-Seki/agent-memory-data-demo).</sub>
 
 ## Try it without installing
 
 ```bash
-git clone https://github.com/Ki-Seki/agent-memory
 git clone https://github.com/Ki-Seki/agent-memory-data-demo
-cd agent-memory
-AGENT_MEMORY_DATA=../agent-memory-data-demo bin/mem ui --keywords-only
+AGENT_MEMORY_DATA=agent-memory-data-demo uvx --from "agent-memory-git[ui]" mem ui --keywords-only
 ```
 
-`AGENT_MEMORY_DATA` points `mem` at the demo repository, so nothing is installed and no hooks
-change. The page needs `numpy`. `--keywords-only` skips the optional embedding model; leave it
-out after `mem ui --fetch-model` to also search by meaning.
+`uvx` runs `mem` from a throwaway environment and `AGENT_MEMORY_DATA` points it at the demo
+repository, so nothing is installed and no hooks change. `--keywords-only` skips the optional
+embedding model; leave it out after `mem ui --fetch-model` to also search by meaning.
 
 ## How it works
 
@@ -79,7 +77,7 @@ protocol copies; `mem doctor` says when they are out of date.
 | `~/.codex/hooks.json` | the same three hooks |
 | `~/.codex/config.toml` | `memories.generate_memories = false`, `memories.use_memories = false`, data repository added to `sandbox_workspace_write.writable_roots` |
 | `~/.codex/AGENTS.md` | a marked block with the protocol |
-| `~/.local/bin/mem` | symlink to `mem`, only if that file does not exist yet (`uv tool install` already puts one there) |
+| `~/.zshrc` or `~/.bashrc` | a marked block putting `~/.local/bin`, where uv installs `mem`, on PATH, only if a new login shell lacks it |
 
 Codex asks you to trust new hooks once: open `/hooks` in Codex and enable the three
 agent-memory hooks.
@@ -141,9 +139,14 @@ uv run pytest
 uv run ruff check .
 ```
 
-From a checkout, `bin/mem` (or `uv run mem`) runs the code in place; `mem install` from there
-points the hooks at that checkout, so edits take effect in the next session.
-`uv tool install --editable .` does the same with `mem` on PATH.
+`uv run mem ...` runs the working copy without touching the installed one. To have every
+session use the working copy, install it in place of the release and rewire the hooks; go back
+the same way:
+
+```bash
+uv tool install --force --editable ".[ui]" && mem install    # the checkout, live
+uv tool install --force "agent-memory-git[ui]" && mem install  # the release again
+```
 
 To release, run `uv run scripts/release.py prepare patch` (or `minor`, `major`) to open a
 version PR. After it is merged, `uv run scripts/release.py publish <PR_NUMBER>` creates the GitHub

{agent_memory_git-0.1.0 → agent_memory_git-0.1.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "agent-memory-git"
-version = "0.1.0"
+version = "0.1.1"
 description = "Shared, git-backed memory for Claude Code and Codex."
 readme = "README.md"
 license = "MIT"

{agent_memory_git-0.1.0 → agent_memory_git-0.1.1}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "agent-memory-git"
-version = "0.1.0"
+version = "0.1.1"
 description = "Shared, git-backed memory for Claude Code and Codex."
 readme = "README.md"
 license = "MIT"

{agent_memory_git-0.1.0 → agent_memory_git-0.1.1}/src/agent_memory/config.py

@@ -7,11 +7,7 @@ from pathlib import Path
 PACKAGE_DIR = Path(__file__).resolve().parent
 PROTOCOL = PACKAGE_DIR / "PROTOCOL.md"
 
-# Running from a source checkout (bin/mem, `uv run`, or an editable install) rather than an
-# installed package: hooks then call the checkout's bin/mem, so edits take effect at once.
-_ROOT = PACKAGE_DIR.parent.parent
-CHECKOUT = _ROOT if (_ROOT / "pyproject.toml").is_file() and (_ROOT / "bin" / "mem").is_file() else None
-CODE_DIR = CHECKOUT or PACKAGE_DIR
+CODE_DIR = PACKAGE_DIR
 
 CONFIG_DIR = Path(os.environ.get("AGENT_MEMORY_CONFIG_DIR", "~/.config/agent-memory")).expanduser()
 CONFIG_FILE = CONFIG_DIR / "config.json"
@@ -20,14 +16,10 @@ PROTOCOL_COPY = CONFIG_DIR / "PROTOCOL.md"  # what Claude Code imports; `mem ins
 
 def mem_command():
     """The argv that runs `mem` with this interpreter, for hooks and background sync."""
-    if CHECKOUT:
-        return [sys.executable, str(CHECKOUT / "bin" / "mem")]
     return [sys.executable, "-m", "agent_memory"]
 
 
 def _mem_path():
-    if CHECKOUT:
-        return CHECKOUT / "bin" / "mem"
     found = shutil.which("mem")
     return Path(found) if found else Path(sys.executable).with_name("mem")
 

{agent_memory_git-0.1.0 → agent_memory_git-0.1.1}/src/agent_memory/install.py

@@ -18,7 +18,7 @@ import tomllib
 from pathlib import Path
 
 from . import config, gitsync
-from .util import HOME
+from .util import HOME, parse_time
 
 STATE_FILE = config.CONFIG_DIR / "install-state.json"
 BEGIN = "<!-- agent-memory:begin -->"
@@ -327,19 +327,13 @@ def install(dry_run=False, claude=True, codex=True):
     _path_plan(plan, state)
 
     plan.show()
-    link_ok = LOCAL_BIN.is_symlink() and LOCAL_BIN.resolve() == config.BIN.resolve()
-    if not link_ok:
-        print(f"=== {LOCAL_BIN} -> {config.BIN} (symlink)\n")
     if dry_run:
         print("dry run: nothing changed")
         return
 
     stamp = _dt.datetime.now().strftime("%Y%m%d-%H%M%S")
     plan.apply(config.CONFIG_DIR / "backups" / stamp)
-    if not link_ok and not LOCAL_BIN.exists():
-        LOCAL_BIN.parent.mkdir(parents=True, exist_ok=True)
-        LOCAL_BIN.symlink_to(config.BIN)
-        state["local_bin"] = str(LOCAL_BIN)
+    state.pop("local_bin", None)  # `uv tool install` owns ~/.local/bin/mem now
     state["installed_at"] = stamp
     state["claude"] = state.get("claude") or (claude and CLAUDE_DIR.is_dir())
     state["codex"] = state.get("codex") or (codex and CODEX_DIR.is_dir())
@@ -427,20 +421,41 @@ def uninstall(dry_run=False):
             plan.edit(Path(rc), _unblock(text, SH_BEGIN, SH_END))
 
     plan.show()
+    # Older installs linked ~/.local/bin/mem to a checkout's bin/mem. Remove that link only once
+    # it points nowhere; a live one now belongs to `uv tool install`.
     local = state.get("local_bin")
+    local = local if local and Path(local).is_symlink() and not Path(local).exists() else None
     if local:
-        print(f"=== remove symlink {local}\n")
+        print(f"=== remove dangling symlink {local}\n")
     if dry_run:
         print("dry run: nothing changed")
         return
     stamp = _dt.datetime.now().strftime("%Y%m%d-%H%M%S")
     plan.apply(config.CONFIG_DIR / "backups" / f"uninstall-{stamp}")
-    if local and Path(local).is_symlink():
+    if local:
         Path(local).unlink()
     STATE_FILE.rename(STATE_FILE.with_name(f"install-state.uninstalled-{stamp}.json"))
     print("uninstalled. Native memory settings restored; the data repository is untouched.")
 
 
+ERROR_DAYS = 7
+_ERROR_LINE = re.compile(r"^(\S+) ERROR in (hook [^:]*):", re.M)
+
+
+def recent_hook_errors(log_text, now=None, days=ERROR_DAYS):
+    """'<time> <where>' for each hook failure logged in the last `days` days, oldest first.
+
+    Other entries, such as errors from the `mem ui` server, are not hook failures.
+    """
+    now = now or _dt.datetime.now().astimezone()
+    out = []
+    for stamp, where in _ERROR_LINE.findall(log_text):
+        t = parse_time(stamp)
+        if t and (now - t).days < days:
+            out.append(f"{stamp} {where}")
+    return out
+
+
 def doctor():
     ok = True
 
@@ -478,6 +493,7 @@ def doctor():
         staged = list((data / "staging").glob("*/*.md")) if (data / "staging").exists() else []
         check(not staged, f"no stuck staged files ({len(staged)})")
         logf = data / ".cache" / "agent-memory.log"
-        errors = (_read(logf) or "").count("ERROR")
-        check(errors == 0, f"hook errors in {logf}: {errors}")
+        errors = recent_hook_errors(_read(logf) or "")
+        latest = f"; latest: {errors[-1]} (details in {logf})" if errors else ""
+        check(not errors, f"no hook errors in the last {ERROR_DAYS} days ({len(errors)}{latest})")
     return 0 if ok else 1

{agent_memory_git-0.1.0 → agent_memory_git-0.1.1}/src/agent_memory/ui_server.py

@@ -296,6 +296,8 @@ class Handler(BaseHTTPRequestHandler):
     def _run(self, fn):
         try:
             self._send(200, fn())
+        except (BrokenPipeError, ConnectionResetError):
+            pass  # the page went away (reload, closed tab) before the reply was written
         except ApiError as e:
             self._send(e.status, {"error": e.message})
         except Exception as e: