v10.1.0

thedotmack/claude-memv10.1.0Feb 16, 2026by thedotmack

AI Summary

This release adds SessionStart system message support enabling hooks to display ANSI-colored timeline summaries directly in the CLI, introduces a clickable 'View Observations Live' link, and implements parallel context fetching for improved performance. New installs now default to a cleaner display with hidden token columns and savings amount.

Key Highlights

  • SessionStart hook now supports systemMessage field for ANSI-colored CLI output
  • Added clickable 'View Observations Live' link (localhost URL) at session start
  • Implemented parallel context fetching using Promise.all for better performance
  • New default settings hide read tokens, work tokens, savings amount, and full observation expansion
  • Existing users' settings are preserved via ~/.claude-mem/settings.json overrides

New Features

  • SessionStart systemMessage support with ANSI-colored timeline display
  • Clickable 'View Observations Live' localhost URL
  • Parallel markdown and timeline context fetching
  • Streamlined default settings for new installations (hidden tokens, hidden savings amount, disabled full observation count)

Full Release Notes

## SessionStart System Message & Cleaner Defaults

### New Features

- **SessionStart `systemMessage` support** — Hooks can now display user-visible ANSI-colored messages directly in the CLI via a new `systemMessage` field on `HookResult`. The SessionStart hook uses this to render a colored timeline summary (separate from the markdown context injected for Claude), giving users an at-a-glance view of recent activity every time they start a session.

- **"View Observations Live" link** — Each session start now appends a clickable `http://localhost:{port}` URL so users can jump straight to the live observation viewer.

### Performance

- **Truly parallel context fetching** — The SessionStart handler now uses `Promise.all` to fetch both the markdown context (for Claude) and the ANSI-colored timeline (for user display) simultaneously, eliminating the serial fetch overhead.

### Defaults Changes

- **Cleaner out-of-box experience** — New installs now default to a streamlined context display:
  - Read tokens column: hidden (`CLAUDE_MEM_CONTEXT_SHOW_READ_TOKENS: false`)
  - Work tokens column: hidden (`CLAUDE_MEM_CONTEXT_SHOW_WORK_TOKENS: false`)
  - Savings amount: hidden (`CLAUDE_MEM_CONTEXT_SHOW_SAVINGS_AMOUNT: false`)
  - Full observation expansion: disabled (`CLAUDE_MEM_CONTEXT_FULL_COUNT: 0`)
  - Savings percentage remains visible by default

  Existing users are unaffected — your `~/.claude-mem/settings.json` overrides these defaults.

### Technical Details

- Added `systemMessage?: string` to `HookResult` interface (`src/cli/types.ts`)
- Claude Code adapter now forwards `systemMessage` in hook output (`src/cli/adapters/claude-code.ts`)
- Context handler refactored for parallel fetch with graceful fallback (`src/cli/handlers/context.ts`)
- Default settings tuned in `SettingsDefaultsManager` (`src/shared/SettingsDefaultsManager.ts`)