agent-memory-git 0.1.7__tar.gz → 0.1.9__tar.gz

{agent_memory_git-0.1.7 → agent_memory_git-0.1.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-memory-git
-Version: 0.1.7
+Version: 0.1.9
 Summary: Shared, git-backed memory for Claude Code and Codex.
 Keywords: claude-code,codex,memory,agents,git
 Author: Shichao Song
@@ -58,6 +58,8 @@ Description-Content-Type: text/markdown
 - **Memory in git.** One Markdown file per memory in a git repository you own, with where it came
   from recorded by the hooks. Every change is a commit you can review or revert; add a private
   remote to sync machines, or keep it all on one. Here is [an example](https://github.com/Ki-Seki/agent-memory-data-demo).
+  [Profiles](https://ki-seki.github.io/agent-memory/docs.html#profiles) keep work and personal
+  memories in repositories of their own.
 - **Nothing to run.** Two hooks and git. No service, no account; search by meaning runs on your CPU.
 - **A page to keep it tidy.** `mem ui` searches by words and by meaning, edits with undo, and shows
   what changed week by week.

{agent_memory_git-0.1.7 → agent_memory_git-0.1.9}/README.md

@@ -37,6 +37,8 @@
 - **Memory in git.** One Markdown file per memory in a git repository you own, with where it came
   from recorded by the hooks. Every change is a commit you can review or revert; add a private
   remote to sync machines, or keep it all on one. Here is [an example](https://github.com/Ki-Seki/agent-memory-data-demo).
+  [Profiles](https://ki-seki.github.io/agent-memory/docs.html#profiles) keep work and personal
+  memories in repositories of their own.
 - **Nothing to run.** Two hooks and git. No service, no account; search by meaning runs on your CPU.
 - **A page to keep it tidy.** `mem ui` searches by words and by meaning, edits with undo, and shows
   what changed week by week.

{agent_memory_git-0.1.7 → agent_memory_git-0.1.9}/pyproject.toml

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

{agent_memory_git-0.1.7 → agent_memory_git-0.1.9}/pyproject.toml.orig

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

{agent_memory_git-0.1.7 → agent_memory_git-0.1.9}/src/agent_memory/cli.py

@@ -8,7 +8,7 @@ import signal
 import sys
 from pathlib import Path
 
-from . import capture, config, frontmatter, gitsync, hooks, select, store
+from . import capture, config, frontmatter, gitsync, hooks, profiles, select, store
 from .context import detect
 from .util import SCOPES, TYPES, atomic_write, slugify
 
@@ -79,7 +79,7 @@ def cmd_index(args):
     data = _data()
     ctx = detect(args.cwd)
     paths = {"memories": str(store.memories_dir(data)), "staging": "(per session)", "mem": str(config.BIN)}
-    text = select.render(store.load_all(data), ctx, paths)
+    text = select.render(store.load_all(data), ctx, paths, profile=profiles.active_name())
     print(text, end="")
     print(f"\n[{len(text)} characters]", file=sys.stderr)
 
@@ -195,7 +195,7 @@ def cmd_ui(args):
         )
         os.execv(sys.executable, [sys.executable, "-m", "agent_memory", *again])
     if os.environ.get(demo.ENV):
-        print("Demo: made-up memories in a temporary repository; nothing you change is kept.", flush=True)
+        print("Demo: made-up memories in temporary repositories; nothing you change is kept.", flush=True)
         atexit.register(shutil.rmtree, os.environ[demo.ENV], ignore_errors=True)
         # closing the terminal (SIGHUP) or `kill` (SIGTERM) would end the process without that clean-up
         for name in ("SIGHUP", "SIGTERM"):
@@ -241,6 +241,43 @@ def cmd_doctor(args):
     return doctor()
 
 
+def _access_note():
+    from .install import refresh_access
+
+    tools = refresh_access()
+    if tools:
+        print(f"updated {' and '.join(tools)} so agents can reach every profile's folder")
+
+
+def cmd_profile(args):
+    if profiles.locked():
+        sys.exit("AGENT_MEMORY_DATA picks the data repository here, so profiles do not apply")
+    try:
+        if args.action == "use":
+            pid = profiles.use(args.profile)
+            print(f"new sessions now use {profiles.listing()[0][pid]['name']}")
+        elif args.action == "add":
+            pid, note = profiles.add(args.folder, remote=args.remote, switch=not args.keep)
+            found, active = profiles.listing()
+            print(note)
+            print(f"added {found[pid]['name']}" + ("; new sessions now use it" if active == pid else ""))
+            _access_note()
+        elif args.action == "remove":
+            found, _ = profiles.listing()
+            pid = profiles.find(args.profile, found)
+            active = profiles.remove(pid)
+            print(f"removed {found[pid]['name']}; {profiles.short(found[pid]['data_dir'])} is left as it is")
+            print(f"new sessions use {profiles.listing()[0][active]['name']}")
+            _access_note()
+        else:
+            for p in profiles.summary()["profiles"]:
+                where = p["remote"] or "this machine only"
+                mark = "*" if p["active"] else " "
+                print(f"{mark} {p['name']:<18} {p['dataDir']}  ({p['memories']} memories, {where})")
+    except profiles.ProfileError as e:
+        sys.exit(str(e))
+
+
 def cmd_hook(args):
     return hooks.main(args.event, args.tool)
 
@@ -336,6 +373,19 @@ def main(argv=None):
     sp = sub.add_parser("doctor", help="check the installation")
     sp.set_defaults(fn=cmd_doctor)
 
+    sp = sub.add_parser("profile", help="list, switch, add or remove profiles: separate memory repositories")
+    psub = sp.add_subparsers(dest="action")
+    psub.add_parser("list", help="list profiles; * marks the one new sessions use")
+    pp = psub.add_parser("use", help="make new sessions (and mem ui) use this profile")
+    pp.add_argument("profile", help="its name, such as quiet-harbor")
+    pp = psub.add_parser("add", help="add a profile for a new, empty or existing memory repository; it gets a name")
+    pp.add_argument("folder", help="its folder; a new or empty one becomes a repository, or a clone of --remote")
+    pp.add_argument("--remote", help="a private git remote of its own (optional)")
+    pp.add_argument("--keep", action="store_true", help="add it without switching to it")
+    pp = psub.add_parser("remove", help="forget a profile; its folder and remote are left as they are")
+    pp.add_argument("profile", help="its name, such as quiet-harbor")
+    sp.set_defaults(fn=cmd_profile)
+
     sp = sub.add_parser("hook", help=argparse.SUPPRESS)
     sp.add_argument("event", choices=["session-start", "stop", "session-end"])
     sp.add_argument("--tool", required=True, choices=["claude-code", "codex"])

{agent_memory_git-0.1.7 → agent_memory_git-0.1.9}/src/agent_memory/config.py

@@ -52,6 +52,10 @@ def save(cfg):
 
 
 def data_dir():
-    """The data repository, or None when not configured."""
-    value = os.environ.get("AGENT_MEMORY_DATA") or load().get("data_dir")
+    """The data repository: AGENT_MEMORY_DATA when set, else the active profile's folder; None when not configured."""
+    value = os.environ.get("AGENT_MEMORY_DATA")
+    if not value:
+        cfg = load()
+        profiles = cfg.get("profiles") if isinstance(cfg.get("profiles"), dict) else {}
+        value = (profiles.get(cfg.get("profile")) or {}).get("data_dir") or cfg.get("data_dir")
     return Path(value).expanduser() if value else None

agent_memory_git-0.1.9/src/agent_memory/demo/personal/2026/08/20260816-blog-publishing-k3qm.md

@@ -0,0 +1,22 @@
+---
+id: 20260816-blog-publishing-k3qm
+name: blog-publishing
+type: project
+scope: here
+description: "blog: posts are Markdown in content/posts and a push to main publishes them; drafts stay in content/drafts"
+created: 2026-08-16T20:40:00+08:00
+source:
+  tool: codex
+  session_id: 58653a77-5fdc-4a8c-91e3-2a91b3a7875d
+  session_name: blog-rss-feed
+  host: alex-laptop
+  cwd: /Users/alex/code/blog
+  git_root: /Users/alex/code/blog
+  git_remote: git.example.com/blog
+  git_branch: main
+---
+The blog is a static site: posts are Markdown files in `content/posts`, and every push to `main` builds and publishes it. Unfinished posts go in `content/drafts`, which is never built.
+
+**Why:** there is no review step, so anything on `main` is live within a minute.
+
+**How to apply:** start new posts in `content/drafts`, and move one to `content/posts` only when Alex says to publish it.

agent_memory_git-0.1.9/src/agent_memory/demo/personal/2026/09/20260906-push-personal-repos-w8re.md

@@ -0,0 +1,22 @@
+---
+id: 20260906-push-personal-repos-w8re
+name: push-personal-repos
+type: feedback
+scope: global
+description: In personal repositories such as the blog and homelab, commit and push without asking first
+created: 2026-09-06T11:15:00+08:00
+source:
+  tool: claude-code
+  session_id: 7bbe96a3-54ec-4718-b2b4-2b0158b7d571
+  session_name: blog-typo-fixes
+  host: alex-laptop
+  cwd: /Users/alex/code/blog
+  git_root: /Users/alex/code/blog
+  git_remote: git.example.com/blog
+  git_branch: main
+---
+In Alex's personal repositories, such as the blog and homelab, commit and push directly; there is no need to ask before each push.
+
+**Why:** they are repositories only Alex works in, with no shared branches, and asking every time slowed down small fixes.
+
+**How to apply:** still keep each commit to one change, and say afterwards what was pushed.

agent_memory_git-0.1.9/src/agent_memory/demo/personal/2026/09/20260921-home-server-n2vb.md

@@ -0,0 +1,18 @@
+---
+id: 20260921-home-server-n2vb
+name: home-server
+type: reference
+scope: global
+description: "Home server nas.home.arpa: Jellyfin on port 8096, nightly backups of /srv to the USB drive at 03:00"
+created: 2026-09-21T16:30:00+08:00
+source:
+  tool: codex
+  session_id: de0fd804-e67d-4793-9580-dd285f8f7eda
+  session_name: homelab-backups
+  host: alex-laptop
+  cwd: /Users/alex/code/homelab
+  git_root: /Users/alex/code/homelab
+  git_remote: git.example.com/homelab
+  git_branch: main
+---
+The home server is `nas.home.arpa` on the home network. Jellyfin runs on port 8096, configured from `jellyfin/` in the homelab repository. `/srv` is backed up every night at 03:00 to the USB drive mounted at `/mnt/backup`.

agent_memory_git-0.1.9/src/agent_memory/demo/personal/2026/10/20261004-options-first-7hcx.md

@@ -0,0 +1,20 @@
+---
+id: 20261004-options-first-7hcx
+name: options-first
+type: user
+scope: global
+description: 个人项目里先给两三个方案和各自的取舍，Alex 选定后再动手写
+created: 2026-10-04T15:05:00+08:00
+source:
+  tool: claude-code
+  session_id: f190571a-9a40-42f5-be8d-2a49882c84b4
+  session_name: 博客评论功能
+  host: alex-laptop
+  cwd: /Users/alex/code/blog
+  git_root: /Users/alex/code/blog
+  git_remote: git.example.com/blog
+  git_branch: main
+---
+做个人项目时，Alex 喜欢先看两三个可选方案和各自的取舍，自己挑一个，再开始写代码。
+
+个人项目主要是为了学东西，选方案的过程本身就是目的；工作项目里则直接按团队惯例做。

{agent_memory_git-0.1.7 → agent_memory_git-0.1.9}/src/agent_memory/demo.py

@@ -1,8 +1,9 @@
 """Made-up memories to try agent-memory with, without installing it or touching your own.
 
-`mem ui --demo` copies them into a temporary data repository whose history has one commit per
-memory, the way the hooks write them, and opens the page on it with its own config folder. The
-project site's live demo is built from the same memories (scripts/site.py).
+There are two profiles of them, one for work and one for home. `mem ui --demo` copies each into a temporary data
+repository whose history has one commit per memory, the way the hooks write them, and opens the page on
+them with a config folder of its own. The project site's live demo is built from the same memories
+(scripts/site.py).
 """
 
 import datetime as _dt
@@ -16,11 +17,20 @@ from pathlib import Path
 
 from . import config, frontmatter, gitsync, install, store
 
-MEMORIES = Path(__file__).with_name("demo") / "memories"
+DEMO = Path(__file__).with_name("demo")
+# the demo's profiles, the active one first, named as profiles.new_name would; each one's memories are in demo/<id>
+PROFILES = {
+    "work": {"name": "Quiet Harbor", "folder": "agent-memory-data"},
+    "personal": {"name": "Sunny Orchard", "folder": "agent-memory-personal"},
+}
 ENV = "AGENT_MEMORY_DEMO"  # set to the demo's temporary folder while a demo runs
 DATES = ("created", "updated")
 
 
+def memories(profile):
+    return DEMO / profile
+
+
 def _when(value):
     try:
         return _dt.datetime.fromisoformat(str(value))
@@ -35,23 +45,31 @@ def _shift(meta, days):
             meta[key] = (when + _dt.timedelta(days=days)).isoformat()
 
 
-def make(dest, today=None):
-    """A data repository at dest holding the demo memories.
+def _newest():
+    """When the newest demo memory, in any profile, was written or changed."""
+    stamps = []
+    for path in DEMO.rglob("*.md"):
+        meta, _ = frontmatter.split(path.read_text("utf-8"))
+        stamps += [_when(meta.get(k)) for k in DATES if _when(meta.get(k))]
+    return max(stamps)
+
+
+def make(dest, today=None, profile="work"):
+    """A data repository at dest holding one profile's demo memories.
 
     Each memory is committed on its own at the time it was created (and again when it was changed),
     with the subject and trailers the Stop hook writes, so Insights has a history to show. With `today`, every date
-    moves by the same number of days so the newest memory is a day old.
+    moves by the same number of days so the newest memory of all the profiles is a day old.
     """
     dest = Path(dest)
     mdir = store.memories_dir(dest)
-    shutil.copytree(MEMORIES, mdir)
+    shutil.copytree(memories(profile), mdir)
     (dest / ".gitignore").write_text("staging/\n.cache/\n", "utf-8")
     (dest / "README.md").write_text(install.DATA_README, "utf-8")
     files = sorted(mdir.rglob("*.md"))
     docs = {path: frontmatter.split(path.read_text("utf-8")) for path in files}
     if today:
-        newest = max(_when(meta.get(k)) for meta, _ in docs.values() for k in DATES if _when(meta.get(k)))
-        days = (today - newest.date()).days - 1
+        days = (today - _newest().date()).days - 1
         for meta, _ in docs.values():
             _shift(meta, days)
 
@@ -93,20 +111,30 @@ def make(dest, today=None):
 
 
 def prepare():
-    """A temporary demo: data repository and config folder, named in the environment for `mem ui`."""
+    """A temporary demo: a data repository per profile and a config folder, named in the environment for `mem ui`.
+
+    Profiles work in it as they do in yours, except that new ones have to stay in its temporary folder.
+    """
     root = Path(tempfile.mkdtemp(prefix="agent-memory-demo-"))
-    data, cfg_dir = root / "data", root / "config"
-    make(data, today=_dt.date.today())
+    cfg_dir = root / "config"
+    profiles = {}
+    for pid, p in PROFILES.items():
+        data = root / p["folder"]
+        make(data, today=_dt.date.today(), profile=pid)
+        profiles[pid] = {"name": p["name"], "data_dir": str(data)}
     cfg_dir.mkdir()
     keep = {k: v for k, v in config.load().items() if k == "embed_model_dir"}  # where the model already is
-    (cfg_dir / "config.json").write_text(json.dumps({"data_dir": str(data), **keep}), "utf-8")
-    os.environ.update({ENV: str(root), "AGENT_MEMORY_DATA": str(data), "AGENT_MEMORY_CONFIG_DIR": str(cfg_dir)})
+    active = next(iter(profiles))
+    cfg = {"data_dir": profiles[active]["data_dir"], "profiles": profiles, "profile": active, **keep}
+    (cfg_dir / "config.json").write_text(json.dumps(cfg, ensure_ascii=False), "utf-8")
+    os.environ.pop("AGENT_MEMORY_DATA", None)  # the profiles pick the folder
+    os.environ.update({ENV: str(root), "AGENT_MEMORY_CONFIG_DIR": str(cfg_dir)})
     return root
 
 
 def fingerprint():
     """A hash of the demo memories, so the site's saved demo data can tell when they change."""
     h = hashlib.sha256()
-    for path in sorted(MEMORIES.rglob("*.md")):
-        h.update(str(path.relative_to(MEMORIES)).encode() + b"\0" + path.read_bytes() + b"\0")
+    for path in sorted(DEMO.rglob("*.md")):
+        h.update(str(path.relative_to(DEMO)).encode() + b"\0" + path.read_bytes() + b"\0")
     return h.hexdigest()[:16]

{agent_memory_git-0.1.7 → agent_memory_git-0.1.9}/src/agent_memory/gitsync.py

@@ -2,6 +2,7 @@
 
 import fcntl
 import os
+import re
 import subprocess
 import time
 from pathlib import Path
@@ -10,6 +11,9 @@ from .config import mem_command
 from .util import log
 
 _ENV = {**os.environ, "GIT_TERMINAL_PROMPT": "0"}
+# what a remote may look like: a URL, scp-style user@host:path, or a folder; never something git reads as an option
+REMOTE_URL = re.compile(r"^(?:(?:https?|ssh|git|file)://\S+|[\w.-]+@[\w.-]+:\S+|[~/]\S*)$")
+BAD_REMOTE = "That does not look like a git remote: use https://…, git@host:owner/repo.git, or a folder."
 
 
 class Lock:
@@ -123,3 +127,42 @@ def spawn_sync(data_dir, push):
             )
     except OSError as e:
         log(data_dir, f"spawn sync failed: {e}")
+
+
+def remote_url(url):
+    """The remote as git should get it, or ValueError when it does not look like one."""
+    url = str(url).strip()
+    if not REMOTE_URL.match(url):
+        raise ValueError(BAD_REMOTE)
+    return os.path.expanduser(url) if url.startswith("~") else url  # git takes a folder as given
+
+
+def connect(data_dir, url):
+    """Make `url` the data repository's origin: (ok, message).
+
+    A remote that already has this branch is pulled from first; an empty one gets this branch pushed to it,
+    so the hooks' pull and push work from then on. ValueError for something that is not a remote.
+    """
+    url = remote_url(url)
+    verb = "set-url" if git(data_dir, "remote", "get-url", "origin").returncode == 0 else "add"
+    r = git(data_dir, "remote", verb, "origin", url)
+    if r.returncode != 0:
+        raise ValueError(f"git remote {verb} failed: {(r.stderr or r.stdout).strip()}")
+    branch = git(data_dir, "branch", "--show-current").stdout.strip() or "main"
+    fetch = git(data_dir, "fetch", "-q", "origin", timeout=60)
+    if fetch.returncode != 0:
+        why = fetch.stderr.strip().splitlines()[-1] if fetch.stderr.strip() else "no answer"
+        return False, f"Saved, but the remote could not be reached: {why}"
+    if git(data_dir, "rev-parse", "--verify", "-q", f"origin/{branch}").returncode == 0:
+        git(data_dir, "branch", f"--set-upstream-to=origin/{branch}")
+        ok = sync(data_dir)
+        return ok, "Connected and synced." if ok else "Connected, but syncing failed; see .cache/agent-memory.log."
+    push = git(data_dir, "push", "-q", "-u", "origin", branch, timeout=60)
+    if push.returncode != 0:
+        return False, f"Saved, but the push failed: {push.stderr.strip()}"
+    return True, "Connected; this repository is pushed to it."
+
+
+def disconnect(data_dir):
+    if has_remote(data_dir):
+        git(data_dir, "remote", "remove", "origin")

{agent_memory_git-0.1.7 → agent_memory_git-0.1.9}/src/agent_memory/hooks.py

@@ -12,7 +12,7 @@ import sys
 import time
 from pathlib import Path
 
-from . import capture, config, gitsync, select, store, workdir
+from . import capture, config, gitsync, profiles, select, store, workdir
 from .context import detect
 from .util import log, log_exc
 
@@ -62,7 +62,13 @@ def session_start(payload, tool, data_dir):
         "staging": str(sdir),
         "mem": str(config.BIN),
     }
-    return select.render(store.load_all(data_dir), ctx, paths, throwaway=workdir.is_throwaway(ctx.get("cwd")))
+    return select.render(
+        store.load_all(data_dir),
+        ctx,
+        paths,
+        throwaway=workdir.is_throwaway(ctx.get("cwd")),
+        profile=profiles.active_name(),
+    )
 
 
 def flush(payload, tool, data_dir, final):
@@ -76,9 +82,21 @@ def flush(payload, tool, data_dir, final):
         gitsync.spawn_sync(data_dir, push=True)
 
 
+def _home(payload, tool, active):
+    """The data repository holding this session's staging folder: the profile that was active when the
+    session started, which need not be the active one now."""
+    sid = payload.get("session_id")
+    for data_dir in profiles.dirs() if sid else []:
+        if capture.session_dir(data_dir, tool, str(sid)).is_dir():
+            return data_dir
+    return active
+
+
 def main(event, tool):
     payload = _payload()
     data_dir = config.data_dir()
+    if data_dir and event != "session-start":
+        data_dir = _home(payload, tool, data_dir)
     if not data_dir or not (data_dir / ".git").exists():
         return 0
     try: