All notable changes to Claude Memory are documented here. This project adheres to Semantic Versioning.

For the complete detailed changelog, see the CHANGELOG.md file in the repository.

Documentation Update Release

• Updated README.md for accuracy and clarity
  • Added "Latest Release" section highlighting v1.11.0 features
  • Updated test count badges (40 tests, 85%+ coverage)
  • Consolidated export/import examples for better readability
  • Reduced repetitive documentation
  • Improved conciseness while maintaining completeness

• Fixed outdated test statistics in README badges
• Streamlined command examples to reduce redundancy
• Added prominent v1.11.0 feature highlights at the top of README

Summary Management & Critical Bug Fixes Release

• Summary Management Commands (Issue #73):
  • summary generate <title>: Create contextual project summaries
  • summary list: List all available summaries
  • summary view <filename>: View specific summary content
  • Summaries include context from current session (tasks, decisions, patterns)
  • Support for linking summaries to specific sessions

• Handoff Command Bug (Issue #54):
  • Handoff now saves to HANDOFF.md by default to prevent data loss
  • Added --stdout flag to output to console when needed
  • Updated help text and documentation to reflect new behavior
• Knowledge Count Bug (Issue #53):
  • Knowledge counts in CLAUDE.md now update immediately
  • Fixed stale count display after add/remove operations

Export, Import & Report Generation Release

• Bulk Task Operations (Issue #27):
  • task add-bulk: Import multiple tasks from JSON files
  • task export: Export tasks in JSON or GitHub issue format
  • JSON schema validation for data integrity
• Enhanced Export Command (Issue #30):
  • Multiple formats: JSON, YAML, CSV, Markdown
  • Type filtering with --types flag
  • Date range filtering with --from and --to
  • Metadata control and sanitization options
• Import Command (Issue #30):
  • Merge mode (default): Adds new items, skips duplicates
  • Replace mode: Clears existing data before importing
  • Comprehensive validation and auto-ID generation
• Report Generation (Issue #30):
  • Six report types: summary, tasks, patterns, decisions, progress, sprint
  • Auto-save with timestamped filenames
  • Date range filtering for focused reports
• Report Auto-Save (Issue #43):
  • --save flag saves to .claude/reports/ with timestamps
  • Custom directory support with --save-dir
• CLAUDE.md Token Optimization:
  • Increased truncation limit: 80 → 120 characters
  • Added Recent Changes section (last 7 days)
  • Updated command examples

• Shared JSON schemas for standardized data formats
• Enhanced test coverage: 76+ comprehensive tests
• Added js-yaml dependency for YAML support

Hotfix Release

• Fixed --help and -h flags not showing general help (Issue #41)
• Enhanced global flags documentation

CLI Enhancement Release

• CLI Flags (Issue #19):
  • --dry-run: Preview changes without executing
  • --config: Use custom configuration file
  • --force: Skip confirmation prompts
  • --debug: Show detailed execution information
  • --version: Display version information
• Comprehensive flag validation and error handling
• Debug mode for troubleshooting

• Code Refactoring (Issue #20):
  • Modularized codebase into utils directory
  • Created validators.js, sanitizers.js, and formatters.js
  • Reduced main file size by 37%
  • Improved maintainability and testability
• Enhanced error messages with debug information
• Improved CLI help formatting

Knowledge Management Enhancement

• Paginated knowledge list display (10 items per page)
• Knowledge count indicator
• Truncation for long knowledge values (50 chars in list view)
• Full details available via knowledge get command

• Knowledge values support unlimited length
• Multi-line content properly preserved
• Improved display formatting

Housekeeping Release

• CLAUDE.md shows "Created with Claude Memory v1.8.1"
• Session duration display improvements
• Enhanced JSON stringify for better readability

• Version referencing throughout codebase
• Session tracking improvements

First Official Public Release

• Complete CLI tool implementation
• Automated session management
• Task tracking system
• Pattern recognition
• Decision logging
• Knowledge base
• Auto-backup functionality
• Token optimization
• Multi-file context system

• 1.9.0: CLI enhancement with global flags
• 1.8.x: Knowledge management improvements
• 1.7.0: Multi-file context system
• 1.6.0: AI handoff summaries
• 1.5.0: Pattern management enhancements
• 1.4.0: Context command improvements
• 1.3.0: Stats display enhancements
• 1.2.0: Import/export functionality
• 1.1.0: Enhanced pattern features
• 1.0.0: Initial release

• Patch releases: As needed for bug fixes
• Minor releases: Monthly or when features ready
• Major releases: Yearly or for breaking changes

See the Roadmap for planned features and improvements.

• Latest version: Always recommended
• Previous minor: Bug fixes only
• Older versions: No support

No breaking changes. New CLI flags are optional and backward compatible.

First public release. If upgrading from pre-release versions:

1. Backup your .claude directory
2. Install latest version
3. Run cmem init to update structure

# Check current version
cmem --version

# Update to latest
npm update -g claude-memory

# Verify update
cmem --version

See also:

• Release-Process - How releases are created
• Roadmap - Future plans
• Full Changelog - Detailed changes