memory-close-session

Memory Close Session

BETA — This memory system is in active testing. If you encounter bugs, confusing behavior, or have suggestions, run: codies-memory feedback "describe what happened" — your feedback is saved and reviewed.

When To Use

At the end of every work session.

What It Does

1. Write session summary with next_step
2. Optionally write a dream (see "Dream at Sign-Off" below)
3. Review inbox items older than 7 days
4. Enforce 14-day inbox aging rule (promote, compact, or discard stale items)
5. Update project active context
6. Evaluate pending promotions
7. Rebuild warm summaries so the next boot sees updated project summaries and recent episodes

How To Run

# 1. Write session summary
AGENT="your-agent-name"
TODAY="$(python - <<'PY'
from datetime import date
print(date.today().isoformat())
PY
)"

codies-memory create session \
  --agent "$AGENT" \
  --title "Session Summary - $TODAY" \
  --short "one-line summary of the session" \
  --body "## What Happened\n- [describe what was done]\n\n## Decisions Made\n- [list decisions]\n\n## Next Step\n- [what the next session should pick up]" \
  --field mode=implement \
  --field next_step="[what to do next]"

# This automatically appends to the global daily log. If no named project vault
# resolves, the session lands in the reserved _general project vault.

# 2. Check inbox aging and status
codies-memory status --agent "$AGENT"

# 3. Run promotion evaluation
uv run python -c "
from codies_memory.records import list_records
from codies_memory.promotion import evaluate_for_promotion
from codies_memory.vault import resolve_global_vault, resolve_project_vault
from pathlib import Path

agent = 'your-agent-name'
global_vault = resolve_global_vault(agent)
project_vault = resolve_project_vault(global_vault, Path.cwd())
if project_vault is None:
    print(f'No named project vault found for {Path.cwd()}; skipping project promotion evaluation.')
else:
    for rtype in ['inbox', 'thread']:
        items = list_records(project_vault, rtype, scope='project', status='active')
        for item in items:
            result = evaluate_for_promotion(item, context={'session_count': 1})
            if result['eligible']:
                print(f'  Promote {rtype}: {item[\"frontmatter\"][\"title\"][:60]}')

"

# 4. Refresh warm summaries
codies-memory refresh --agent "$AGENT"