// Create or update a session memory log. Called automatically by context threshold reminders, or manually to force a memory write.
Migrate an existing simple-session-memory installation to match the current release format. Run this after upgrading the template to bring CLAUDE.md instructions, directory structure, and index.md up to date.
Configure the cc-context-awareness context window warning system. Use when the user wants to change context warning thresholds, messages, or other cc-context-awareness settings.
| name | log-session-memory |
| description | Create or update a session memory log. Called automatically by context threshold reminders, or manually to force a memory write. |
This guide covers the full procedure for creating and updating session memory logs. Read it when a context threshold reminder fires or when you need to write a log manually.
Each session gets its own directory:
.claude/memory/
session-YYYY-MM-DD-NNN/
session-YYYY-MM-DD-NNN.md # the session log
<supplementary files> # optional — analysis, plans, research
index.md
archives/
NNN is a per-day counter that resets each calendar day.
Before creating a new log, check if one already exists for your session:
Search .claude/memory/session-*/session-*.md for a file with your session_id in its YAML frontmatter. If found, that is your log — update it instead of creating a new one.
session-YYYY-MM-DD-*/ directories in .claude/memory/ matching today's date001, 002).claude/memory/session-YYYY-MM-DD-NNN/.claude/memory/session-YYYY-MM-DD-NNN/session-YYYY-MM-DD-NNN.md---
date: YYYY-MM-DD
session_id: <your session ID>
context_at_log: <percentage>%
continues: <previous-session-name> # only for continuations — omit on fresh sessions
---
## Current Work
[What task or project is being worked on and its current state]
## Completed This Session
[What was accomplished — specific files, features, fixes]
## Key Decisions
[Important technical or design choices made, and why]
## Files Modified
[Key files created or changed with brief descriptions]
- `path/to/file.ts` — description of change
## In Progress
[Anything started but not finished]
## Next Steps
[Specific actions to take next session — enough detail to continue immediately]
## Notes
[User preferences, known issues, environment details, other context]
At 65% and 80% context, update the log in place — edit the existing sections to reflect current state. Do not append or duplicate sections. Update context_at_log in the YAML frontmatter to the current percentage so the recency of the log is always visible.
At 80%, make Next Steps highly specific — exact file paths, function names, what state things are in. Write as if handing off to someone who has never seen this session.
When content exceeds ~50 lines (analysis findings, research output, detailed tables, design specs), write it as a separate file in the session directory alongside the log:
.claude/memory/session-2026-03-04-002/
session-2026-03-04-002.md # log — summarizes findings
exploration-findings.md # supplementary — full detail
refactor-plan.md # supplementary — full detail
No special YAML field needed — co-location makes the relationship clear. Supplementary files are ephemeral and deleted during archival.
After creating or updating a log, update .claude/memory/index.md.
Add or update a row for your session. Most recent at the top. Use the session stem (no .md):
| Session | Date | Summary |
|---------|------|---------|
| session-2026-03-04-002 | 2026-03-04 | One-sentence summary of current work |
If the file doesn't exist, create it:
# Session Memory Index
## Active Sessions
| Session | Date | Summary |
|---------|------|---------|
## Archives
| Archive | Period | Summary |
|---------|--------|---------|
## Appendices
The index is the historical record and process knowledge store. Beyond session tables, appendices capture durable observations:
These accumulate and persist. They are not working technical notes about current codebase state — those belong in MEMORY.md.
Ownership: Claude updates Active Sessions only. The memory-archiver agent manages Archives and Appendices.