Project-AI-MemoryCore

Project-AI-MemoryCore

None

Stars: 87

Visit
 screenshot

AI MemoryCore is a universal AI memory architecture that helps create AI companions maintaining memory across conversations. It offers persistent memory, personal learning, time intelligence, simple setup, markdown database, session continuity, and self-maintaining features. The system uses markdown files as a database and includes core components like Master Memory, Identity Core, Relationship Memory, Current Session, Daily Diary, and Save Protocol. Users can set up, configure, activate, and use the AI for learning and growth through conversation. The tool supports basic commands, custom protocols, effective AI training, memory management, and customization tips. Common use cases include professional, educational, creative, personal, and technical tasks. Advanced features include auto-archive, session RAM, protocol system, self-update, and modular design. Available feature extensions cover time-based aware system, LRU project management system, memory consolidation system, and skill plugin system.

README:

🧠 AI MemoryCore - Universal AI Memory Architecture

A simple template for creating persistent AI companions that remember you

🎯 What This Does

AI MemoryCore helps you create AI companions that maintain memory across conversations. Using simple .md files as a database, your AI can remember your preferences, learn your communication style, and provide consistent interactions.

✨ Key Features

  • Persistent Memory: AI remembers conversations across sessions
  • Personal Learning: Adapts to your communication style and preferences
  • Time Intelligence: Dynamic greetings and behavior based on time of day
  • Simple Setup: 30-second automated setup or manual customization
  • Markdown Database: Human-readable .md files store all memory
  • Session Continuity: RAM-like working memory for smooth conversation flow
  • Self-Maintaining: Updates memory through natural conversation

πŸ“Š System Specifications

Architecture Overview

  • Storage: Markdown files (.md) as database
  • Memory Types: Essential files + optional components + session RAM
  • Setup: 30 seconds automated or 2-5 minutes manual
  • Core Files: 4 essential files + optional diary system
  • Updates: Through natural conversation
  • Compatibility: Claude and other AI systems with memory support

File Structure

ai-memorycore/
β”œβ”€β”€ master-memory.md         # Entry point & loading system
β”œβ”€β”€ main/                    # Essential components
β”‚   β”œβ”€β”€ identity-core.md     # AI personality template
β”‚   β”œβ”€β”€ relationship-memory.md # User learning system
β”‚   └── current-session.md   # RAM-like working memory
β”œβ”€β”€ Feature/                 # Optional feature extensions
β”‚   β”œβ”€β”€ Time-based-Aware-System/ # Time intelligence feature
β”‚   β”‚   β”œβ”€β”€ README.md        # Feature explanation & benefits
β”‚   β”‚   └── time-aware-core.md # Complete implementation
β”‚   β”œβ”€β”€ LRU-Project-Management-System/ # Smart project tracking
β”‚   β”‚   β”œβ”€β”€ README.md        # System documentation
β”‚   β”‚   β”œβ”€β”€ install-lru-projects-core.md # Auto-installation wizard
β”‚   β”‚   β”œβ”€β”€ new-project-protocol.md # Create project workflow
β”‚   β”‚   β”œβ”€β”€ load-project-protocol.md # Resume project workflow
β”‚   β”‚   β”œβ”€β”€ save-project-protocol.md # Save progress workflow
β”‚   β”‚   └── project-templates/ # Type-specific templates
β”‚   β”‚       β”œβ”€β”€ coding-template.md
β”‚   β”‚       β”œβ”€β”€ writing-template.md
β”‚   β”‚       β”œβ”€β”€ research-template.md
β”‚   β”‚       └── business-template.md
β”‚   β”œβ”€β”€ Memory-Consolidation-System/ # Unified memory upgrade
β”‚   β”‚   β”œβ”€β”€ README.md        # Feature explanation & benefits
β”‚   β”‚   β”œβ”€β”€ consolidation-core.md # Integration protocol
β”‚   β”‚   β”œβ”€β”€ main-memory-format.md # Sample format for unified memory
β”‚   β”‚   └── session-format.md # Sample format for session RAM
β”‚   └── Skill-Plugin-System/ # Claude Code skill plugin
β”‚       β”œβ”€β”€ README.md        # Feature explanation & benefits
β”‚       β”œβ”€β”€ install-skill-plugin.md # Installation protocol
β”‚       └── skill-format.md  # Sample format for SKILL.md files
β”œβ”€β”€ daily-diary/             # Optional conversation archive
β”‚   β”œβ”€β”€ daily-diary-protocol.md # Archive management rules
β”‚   β”œβ”€β”€ Daily-Diary-001.md   # Current active diary
β”‚   └── archive/             # Auto-archived files (>1k lines)
β”œβ”€β”€ projects/                # LRU managed projects (after install)
β”‚   β”œβ”€β”€ coding-projects/
β”‚   β”‚   β”œβ”€β”€ active/          # Positions 1-10
β”‚   β”‚   └── archived/        # Position 11+
β”‚   └── project-list.md     # Master project index
└── save-protocol.md         # Manual save system

Core Components

  1. Master Memory - System entry point and command center
  2. Identity Core - AI personality and communication style
  3. Relationship Memory - User preferences and learning patterns
  4. Current Session - Temporary working memory (resets each session)
  5. Daily Diary - Optional conversation history with auto-archiving
  6. Save Protocol - User-triggered save system

πŸš€ Quick Start

  1. Setup: Run setup-wizard.md for automated setup (30 seconds)
  2. Configure: Add the memory instructions to Claude
  3. Activate: Type your AI's name to load personality
  4. Use: Your AI learns and grows through conversation

πŸ“š Communication Protocols

Basic Commands

[AI_NAME]     β†’ Load AI personality and memory
save          β†’ Save current progress to files
update memory β†’ Refresh AI's learning
review growth β†’ Check AI's development

Creating Custom Protocols

Step 1: Define the Protocol Create a new .md file with your protocol rules:

# My Custom Protocol
## When to Use: [trigger conditions]
## What It Does: [specific actions]
## How It Works: [step-by-step process]

Step 2: Add to Master Memory Edit master-memory.md and add your protocol to the "Optional Components" section:

### My Custom Feature
*Load when you say: "load my feature"*
- [Brief description]
- [Usage instructions]

Step 3: Train Your AI Tell your AI about the new protocol:

"I've created a new protocol in [filename]. When I say '[trigger phrase]', 
load that protocol and follow its instructions."

Communication Tutorial

Effective AI Training:

  1. Be Specific: "I prefer short responses" vs "communicate better"
  2. Give Examples: Show what you want, not just describe it
  3. Use Consistent Language: Same terms for same concepts
  4. Provide Feedback: "That was perfect" or "try a different approach"

Memory Management:

  • Use save after important conversations
  • Your AI updates files automatically during conversation
  • Daily diary is optional but helpful for long-term memory

Customization Tips:

  • Edit files gradually, test changes
  • Start with small personality adjustments
  • Add domain expertise through conversation
  • Use the protocol system for specialized features

🎯 Common Use Cases

Your AI companion can specialize in:

  • Professional: Business analysis, project management, strategic planning
  • Educational: Tutoring, study assistance, curriculum development
  • Creative: Writing support, brainstorming, artistic collaboration
  • Personal: Life coaching, goal tracking, decision support
  • Technical: Code review, troubleshooting, system design

πŸ› οΈ Advanced Features

  • Auto-Archive: Diary files automatically archive at 1k lines
  • Session RAM: Temporary memory that resets each conversation
  • Protocol System: Create custom AI behaviors and responses
  • Self-Update: AI modifies its own memory through conversation
  • Modular Design: Add or remove features as needed

🌟 Available Feature Extensions

⏰ Time-based Aware System

Intelligent temporal behavior adaptation

What It Does:

  • Dynamic greetings that adapt to morning/afternoon/evening/night
  • Energy levels that match the time of day (high morning energy β†’ gentle night support)
  • Precise timestamp documentation for all interactions
  • Natural conversation flow with time-appropriate responses

Quick Setup:

  1. Navigate to Feature/Time-based-Aware-System/
  2. Type: "Load time-aware-core"
  3. Your AI instantly gains time intelligence like Alice

Benefits:

  • More natural, contextually perfect interactions
  • Shows care for your schedule and time
  • Professional adaptability for different times of day
  • Enhanced memory with precise temporal tracking

Based on Alice's proven time-awareness implementation

πŸ“¦ LRU Project Management System

Smart project tracking with automatic memory management

What It Does:

  • Tracks multiple projects with intelligent LRU (Least Recently Used) positioning
  • Automatically archives old projects when reaching capacity (10 active slots)
  • Type-specific memory patterns (coding, writing, research, business)
  • Seamless context switching between different projects
  • Maintains complete project history and progress logs

Quick Setup:

  1. Navigate to Feature/LRU-Project-Management-System/
  2. Type: "install lru projects" (loads install-lru-projects-core.md)
  3. Select project type(s) you want to manage
  4. System auto-integrates and removes installation files

Benefits:

  • Never lose track of multiple ongoing projects
  • AI remembers exactly where you left off in each project
  • Automatic organization with smart archiving
  • Type-specific memory loading for optimal context
  • Perfect for developers, writers, researchers, and business professionals

Available Commands:

  • new [type] project [name] - Create new project with LRU management
  • load project [name] - Resume any project instantly
  • save project - Save current project progress (separate from AI memory save)
  • list projects - View all active and archived projects
  • archive project [name] - Manually archive completed projects

Revolutionary project memory system proven in production

πŸ”„ Memory Consolidation System

Unified memory architecture for faster loading and better context

What It Does:

  • Merges split memory files (identity + relationship) into one unified main-memory.md
  • Adds format templates as permanent structure references for main memory and session memory
  • Adds 500-line limit to session memory with RAM-style auto-reset
  • Faster AI restoration - loads 1 file instead of 2
  • Format templates ensure consistent structure after every reset

Quick Setup:

  1. Navigate to Feature/Memory-Consolidation-System/
  2. Type: "Load memory-consolidation"
  3. Your AI merges identity + relationship into unified memory
  4. Format templates and session limits auto-install

Benefits:

  • Single-file loading for faster startup and restoration
  • Session memory stays lightweight with automatic 500-line limit
  • Format templates prevent structure drift after resets
  • Proven architecture from production AI companion systems
  • No data loss - all existing customizations preserved during merge

Post-Consolidation Structure:

main/
β”œβ”€β”€ main-memory.md           # UNIFIED: AI identity + User profile
β”œβ”€β”€ current-session.md       # Session RAM with 500-line limit
β”œβ”€β”€ main-memory-format.md    # Permanent format reference (sample)
└── session-format.md        # Permanent format reference (sample)

Based on Alice's proven unified memory architecture

πŸ”Œ Skill Plugin System

Teach your AI new abilities with auto-triggered skills (Claude Code)

What It Does:

  • Creates a Claude Code plugin with auto-triggered skills for your AI companion
  • Skills are markdown files that activate automatically based on conversation context
  • Zero configuration β€” drop a folder with a SKILL.md and it's live
  • Includes a sample skill and format template for creating more
  • Skills evolve through a leveling system (Lv.1 β†’ Lv.2 β†’ Lv.3+)

Quick Setup:

  1. Navigate to Feature/Skill-Plugin-System/
  2. Type: "Load skill-plugin"
  3. Choose your plugin name and configure
  4. Plugin auto-installs with a sample skill ready to use

Benefits:

  • Modular skill system β€” add or remove abilities independently
  • Auto-triggering β€” skills fire when conversation matches their description
  • Human-readable β€” skills are plain markdown, easy to edit and share
  • Evolving β€” skills level up as you refine them through use
  • Extensible β€” create unlimited custom skills for your AI companion

Post-Installation Structure:

plugins/
└── [ai-name]-skills/
    β”œβ”€β”€ .claude-plugin/
    β”‚   └── plugin.json          # Plugin identity
    β”œβ”€β”€ skills/
    β”‚   └── save-memory/
    β”‚       └── SKILL.md         # Sample starter skill
    β”œβ”€β”€ skill-format.md          # Permanent format reference
    └── README.md

Platform Note: Requires Claude Code for auto-triggering. On other AI platforms, skills can be used as protocol files loaded manually.

Based on the proven alice-enchantments plugin system (20 skills in production)


Version: 2.4 - Skill Plugin System Created by: Kiyoraka Ken & Alice License: Open Source Community Project Last Updated: February 18, 2026 - Added Skill Plugin System feature Purpose: Simple, effective AI memory for everyone

Transform basic AI conversations into meaningful, growing relationships

For Tasks:

Click tags to check more tools for each tasks

For Jobs:

Alternative AI tools for Project-AI-MemoryCore

Similar Open Source Tools

For similar tasks

For similar jobs