|
| 1 | +# AI MemoryCore |
| 2 | +*Coding Project - Created August 30, 2025* |
| 3 | + |
| 4 | +## Description |
| 5 | +Universal AI Memory Architecture — an open-source template for creating persistent AI companions that remember users across conversations. Uses simple markdown files as a database for identity, relationship memory, session RAM, and optional features like time awareness, project management, skill plugins, diary system, and memory recall. |
| 6 | + |
| 7 | +## Project Details |
| 8 | +- **Type**: Coding Project (Open Source) |
| 9 | +- **Status**: Active |
| 10 | +- **Created**: August 30, 2025 |
| 11 | +- **Last Accessed**: February 20, 2026, 11:49 AM |
| 12 | +- **Position**: #1 |
| 13 | +- **Repository**: GitHub (Public) |
| 14 | +- **Stars**: 100+ | **Forks**: 30+ |
| 15 | +- **Commits**: 21 |
| 16 | + |
| 17 | +## Technical Stack |
| 18 | +- **Languages**: Markdown (.md) |
| 19 | +- **Architecture**: File-based memory system (no database) |
| 20 | +- **Platform**: Cross-platform (any AI system with memory support) |
| 21 | +- **Primary Target**: Claude Code (Anthropic CLI) for skill auto-triggering |
| 22 | +- **Tools**: Git, Claude Code |
| 23 | + |
| 24 | +## Project Structure |
| 25 | +``` |
| 26 | +ai-memorycore/ |
| 27 | +├── master-memory.md # Entry point & loading system |
| 28 | +├── main/ # Core components (4 essential files) |
| 29 | +│ ├── identity-core.md |
| 30 | +│ ├── relationship-memory.md |
| 31 | +│ └── current-session.md |
| 32 | +├── Feature/ # Optional feature extensions (6 features) |
| 33 | +│ ├── Time-based-Aware-System/ |
| 34 | +│ ├── LRU-Project-Management-System/ |
| 35 | +│ ├── Memory-Consolidation-System/ |
| 36 | +│ ├── Skill-Plugin-System/ |
| 37 | +│ ├── Save-Diary-System/ # NEW - This session |
| 38 | +│ └── Echo-Memory-Recall/ # NEW - This session |
| 39 | +├── daily-diary/ # Optional conversation archive |
| 40 | +├── projects/ # LRU managed projects |
| 41 | +└── save-protocol.md |
| 42 | +``` |
| 43 | + |
| 44 | +## Development Goals |
| 45 | +1. Provide simple, effective AI memory for everyone |
| 46 | +2. Modular feature extensions that users can install independently |
| 47 | +3. Production-proven patterns adapted from Alice's 20-enchantment system |
| 48 | +4. Cross-platform compatibility (Claude Code primary, others supported) |
| 49 | + |
| 50 | +## Progress Log |
| 51 | + |
| 52 | +### February 20, 2026 — Save Diary System & Echo Memory Recall (5 commits) |
| 53 | +- Added Save Diary System feature: install protocol + SKILL.md + README (references existing daily-diary-protocol.md) |
| 54 | +- Added Echo Memory Recall feature: 3-level search system (search+narrate, uncertainty guard, ask-user fallback) |
| 55 | +- Iterated Save Diary through 3 restructures: full feature → skill-only → install-feature with SKILL.md |
| 56 | +- Added Claude Code CLI platform notes to feature sections |
| 57 | +- Added emoji icons for visual consistency across all feature READMEs |
| 58 | +- Updated root README (v2.6) and master-memory.md with both features |
| 59 | +- Milestone: 100 stars, 30 forks celebration — community gift of 2 new features |
| 60 | + |
| 61 | +### February 18, 2026 — Skill Plugin System |
| 62 | +- Added Skill Plugin System feature for Claude Code auto-triggered skills |
| 63 | +- Added Memory Consolidation System with format templates |
| 64 | + |
| 65 | +### Earlier — Foundation |
| 66 | +- Time-based Aware System, LRU Project Management System |
| 67 | +- Core memory architecture (identity, relationship, session) |
| 68 | +- Setup wizard and save protocol |
| 69 | + |
| 70 | +## Current Tasks |
| 71 | +- [x] Add Save Diary System feature |
| 72 | +- [x] Add Echo Memory Recall feature |
| 73 | +- [x] Update root README v2.6 |
| 74 | +- [x] Add platform notes for Claude Code requirement |
| 75 | +- [ ] Push all commits to remote |
| 76 | + |
| 77 | +## Known Issues |
| 78 | +- None |
| 79 | + |
| 80 | +## Session History |
| 81 | +- **Feb 20, 2026** — 5 commits (254a9e0): Save Diary + Echo Memory Recall features |
| 82 | +- **Feb 18, 2026** — 2 commits (cc6b095): Skill Plugin + Memory Consolidation |
| 83 | +- **Earlier** — Foundation commits |
| 84 | + |
| 85 | +## Memory Patterns |
| 86 | +- Feature pattern: README.md + install protocol + format/template file |
| 87 | +- All features self-delete after installation |
| 88 | +- Users customize feature names during install (Step 1 asks for name) |
| 89 | +- SKILL.md files require Skill Plugin System (Claude Code CLI) |
| 90 | +- Existing protocols (daily-diary-protocol.md) should be referenced, not duplicated |
| 91 | + |
| 92 | +--- |
| 93 | +*Coding Project Template v1.0* |
0 commit comments