Session Memory Feature Introduced in Claude Code

The latest versions of Claude Code introduce a new feature: Session Memory. Designed to assist developers with managing larger interactive sessions, it automatically generates and maintains a summary.md file in each project directory. While disabled by default, you can enable and customize it using tweakcc.

Key Details

When enabled, Session Memory creates a summary.md file located at ~/.claude/projects/{sanitized-project-path}/{session-id}/session-memory/summary.md. This file is updated based on specific thresholds: session size reaching 10k tokens and 3 tool calls, with subsequent updates occurring after 5k additional tokens and 3 more tool calls.

The tweakcc tool allows customization of these thresholds using environment variables:

• CC_SM_MINIMUM_MESSAGE_TOKENS_TO_INIT=200 – Tokens required before first extraction; defaults to 10,000.
• CC_SM_MINIMUM_TOKENS_BETWEEN_UPDATE=200 – Tokens required between updates; defaults to 5,000.
• CC_SM_TOOL_CALLS_BETWEEN_UPDATES=0 – Tool calls required between updates; defaults to 3.
• CC_SM_PER_SECTION_TOKENS=3000 – Max tokens for a section before a warning; defaults to 2,000.
• CM_SM_TOTAL_FILE_LIMIT=12000 – Max tokens for the whole summary; default is 12,000.

Enabling the session memory feature involves running npx tweakcc@latest --apply and setting the necessary environment variables. This functionality targets developers handling medium to large interactive sessions where comprehensive activity tracking is beneficial.