lucid-mem 0.2.0 → 0.2.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AgentMemoryRepo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,46 @@
+# lucid-mem
+
+Autonomous, git-backed memory for AI coding agents. `amr` keeps what your agents learn across sessions and across repositories: it injects memory at session start, lets agents save durable facts while they work, syncs through git, and maintains itself with scheduled dreaming — no manual invocation.
+
+Implements the [Agent Memory Repo spec](https://github.com/AgentMemoryRepo/agentmemoryrepo). Full docs and per-host details live in the [project repo](https://github.com/tonythethompson/lucid-mem).
+
+## Install
+
+```sh
+npm i -g lucid-mem        # gives you `amr` (and `lucid` as an alias)
+amr ensure                # create the memory repo (default ~/agent-memory, $AMR_HOME to override)
+amr install               # wire rules + hooks + MCP into detected agent hosts
+amr doctor                # verify everything
+```
+
+Then start a session in a wired host — Cursor, Claude Code, Windsurf, Devin, Copilot, Codex, Cline, Muse, Claude Desktop, Antigravity, OpenCode, CommandCode, or Freebuff — and memory is already in context.
+
+## Daily use
+
+Mostly you don't touch it; agents do. Useful by hand:
+
+```sh
+amr context               # what a session here would see
+amr add "I prefer concise summaries"          # global memory
+amr add "uses Kokoro-82M for TTS" --project   # this repo's memory
+amr search "tts"
+amr link other-repo       # auto-attach another repo's memory to sessions here
+amr discover              # which hot repos still lack memory
+amr dream --fix --compact # dedupe + archive overflow
+```
+
+Memory lives in `~/agent-memory` — a real git repo you can read, diff, and point at a private remote (`amr remote set <url>`) for sync and backup.
+
+## Multi-repo memory
+
+One memory repo serves every project. `projects/<name>-<hash>.md` files key off the repo's origin remote, so clones share memory and same-named repos don't collide. `amr link` attaches related projects (transitively); `private` policy keeps a project out of transitive auto-attach; `noglobal` skips global memory for a repo.
+
+## MCP
+
+`amr serve` is a stdio MCP server (`memory_context`, `memory_add`, `memory_search`, `memory_update`) — `amr install` registers it with hosts that support MCP.
+
+## Links
+
+- Repo: https://github.com/tonythethompson/lucid-mem
+- Spec: https://github.com/AgentMemoryRepo/agentmemoryrepo
+- License: MIT

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "lucid-mem",
-  "version": "0.2.0",
-  "description": "lucid-mem (amr) — autonomous git-backed agent memory (Agent Memory Repo spec)",
+  "version": "0.2.1",
+  "description": "lucid-mem (amr) - autonomous git-backed agent memory (Agent Memory Repo spec)",
   "type": "module",
   "bin": {
     "amr": "./amr.mjs",