w1n5t0n/OptMem
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

wake refuses only when the document itself needs the merge; otherwise it hands it over after the read

Browse source
This commit is contained in:
victortaelin 2026-07-26 15:34:09 -03:00
parent 6987d45a94
commit 7b9e582dc9
2 changed files with 19 additions and 13 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

6
README.md
View file

@ -1,6 +1,6 @@
# OptMem # OptMem
Permanent memory for AI agents. A 335-token prompt, a script, plug and play. Permanent memory for AI agents. A 333-token prompt, a script, plug and play.
![how OptMem works](anim/optmem.gif) ![how OptMem works](anim/optmem.gif)
@ -69,8 +69,8 @@ Without it you do not know who you are, or what was decided and tried.
### At startup: activating OptMem (mandatory) ### At startup: activating OptMem (mandatory)
Run `~/.optmem/memo wake` before any other tool call, in every session, and do Run `~/.optmem/memo wake` before any other tool call, in every session, and
exactly what it prints, until it prints `You are awake.` then do exactly what it prints, to the end of its output.
### While working: register memories (mandatory) ### While working: register memories (mandatory)

26
memo
View file

@ -415,8 +415,8 @@ Without it you do not know who you are, or what was decided and tried.
### At startup: activating OptMem (mandatory) ### At startup: activating OptMem (mandatory)
Run `{memo} wake` before any other tool call, in every session, and do Run `{memo} wake` before any other tool call, in every session, and
exactly what it prints, until it prints `You are awake.` then do exactly what it prints, to the end of its output.
### While working: register memories (mandatory) ### While working: register memories (mandatory)
@ -503,13 +503,6 @@ def cmd_wake(d, args):
% (T, plural(now, "entry"))) % (T, plural(now, "entry")))
# A part is rendered as of T, so a note landing between two parts cannot # A part is rendered as of T, so a note landing between two parts cannot
# shift a boundary and drop a line. # shift a boundary and drop a line.
nap = next_nap(d, T)
if nap:
n = max(1, pending_count(d, T))
print("Cannot wake: %s pending. Do %s, then run memo wake again.\n"
% (plural(n, "compression"), "it" if n == 1 else "them"))
print(nap)
sys.exit(1)
if not T: if not T:
print("No memories yet. Record the first with: memo note \"<one line>\"") print("No memories yet. Record the first with: memo note \"<one line>\"")
print("You are awake.") print("You are awake.")
@ -521,7 +514,17 @@ def cmd_wake(d, args):
else: else:
s = tree_get(d, lo, hi) s = tree_get(d, lo, hi)
if s is None: if s is None:
die("Summary %d-%d is missing. Run: memo sleep" % (lo, hi - 1)) # The ONLY reason to refuse: this document cannot be written
# without that summary. Work that the document does not need
# is handed over after the read instead, costing no round
# trip.
print("Cannot wake: the memory context needs #%d-%d, which is "
"not compressed yet.\nDo the %s below, then run memo "
"wake again.\n"
% (lo, hi - 1,
plural(pending_count(d, T), "compression")))
print(next_nap(d, T))
sys.exit(1)
lines.append("#%d-%d %s" % (lo, hi - 1, s)) lines.append("#%d-%d %s" % (lo, hi - 1, s))
parts = paginate(lines) parts = paginate(lines)
if not 1 <= k <= len(parts): if not 1 <= k <= len(parts):
@ -539,6 +542,9 @@ def cmd_wake(d, args):
# always, even for a one-part memory: the contract an agent is given # always, even for a one-part memory: the contract an agent is given
# is "run parts until one says awake", so it must always arrive # is "run parts until one says awake", so it must always arrive
print("You are awake.") print("You are awake.")
nap = next_nap(d, T)
if nap:
print("\n" + nap)
def cmd_note(d, args): def cmd_note(d, args):