Skip to content

Add Memory System for persistent semantic memory (v3.5)#55

Merged
cdnsteve merged 6 commits intodevelopfrom
feature/memory-system
Jan 21, 2026
Merged

Add Memory System for persistent semantic memory (v3.5)#55
cdnsteve merged 6 commits intodevelopfrom
feature/memory-system

Conversation

@cdnsteve
Copy link
Member

Summary

  • Add persistent semantic memory system for AI coding sessions
  • Store decisions, preferences, error patterns, and more across sessions
  • Semantic search with sentence-transformers or keyword fallback
  • MCP server integration for Claude Code

New Features

  • sugar remember - Store memories with type, tags, TTL, importance
  • sugar recall - Semantic/keyword search over memories
  • sugar memories - List all stored memories
  • sugar forget - Delete memories
  • sugar export-context - Export for Claude Code hooks
  • sugar memory-stats - Show memory statistics
  • sugar mcp memory - Start MCP server for Claude Code

Technical Details

  • SQLite + sqlite-vec for vector storage
  • FTS5 fallback when embeddings unavailable
  • sentence-transformers (all-MiniLM-L6-v2) for local embeddings
  • 6 memory types with configurable TTL
  • Optional dependencies pattern for graceful degradation

Test plan

  • 24 new tests for memory functionality
  • All 813 tests passing
  • Manual testing of CLI commands
  • Test MCP server with Claude Code

Files Changed

  • sugar/memory/ - New memory module (types, store, embedder, retriever)
  • sugar/mcp/memory_server.py - MCP server for Claude Code
  • sugar/main.py - CLI commands
  • pyproject.toml - Optional dependencies
  • docs/user/memory.md - Full documentation

- Add sugar/memory module with store, embedder, retriever, types
- Add CLI commands: remember, recall, memories, forget, export-context, memory-stats
- Add MCP memory server for Claude Code integration
- Support semantic search with sentence-transformers (optional)
- Fallback to FTS5 keyword search when embeddings unavailable
- Add optional dependencies: memory, all extras in pyproject.toml
- Add 24 comprehensive tests for memory functionality
- Update README, CHANGELOG, and CLI reference documentation
@cdnsteve cdnsteve merged commit bf640bc into develop Jan 21, 2026
22 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant