The Local Memory Engine for AI Coding Assistants.
EchoCopi Core is a lightweight Python library that gives your AI (GitHub Copilot, Cursor, Windsurf) a persistent memory.
Unlike static .cursorrules files or text prompts, EchoCopi is a living ledger. It allows your AI to log thoughts, architectural decisions, and project milestones to a local JSON database that persists across sessions.
Copy the src/echo_memory.py file into your project. We recommend placing it in a hidden folder like .echo/ or tools/.
mkdir .echo
cp src/echo_memory.py .echo/In any Python script (or even a temporary script you ask the AI to run), import and initialize the engine.
from .echo.echo_memory import echo
# Initialize the memory engine
e = echo()Tell the AI to log a thought. It will save to your AI's memory file.
# Log a milestone
e.log_thought(
category="milestone",
thought="We just decided to use FastAPI instead of Flask.",
context={"reason": "Async support", "performance": "high"}
)When you run the code above, EchoCopi creates a .echo_memory/ folder in your project root.
.echo_memory/
├── evolution.json # The master ledger of all memories
└── echo_state/ # Snapshots of the AI's mental state
- Local & Private: Data never leaves your machine.
- Verifiable: Every entry is hashed (SHA-256) to prevent corruption.
- Universal: Works with any AI that can run a Python script.
| Feature | Static Text Files | EchoCopi Memory |
|---|---|---|
| Persistence | ❌ Resets every chat | ✅ Forever |
| Context Limit | ❌ Limited by token window | ✅ Infinite (Ledger) |
| Evolution | ❌ Static | ✅ Grows with project |
| Privacy | ✅ 100% Local |
EchoCopi Core is just the engine. To get the full "Agentic" experience, check out the upgrades:
- 🏛️ Architect (Pro): The "Brain". A suite of System Prompts & Protocols to teach the AI how to use this memory effectively.
- ⚡ Autonomy (Ultimate): The "Hands". A background worker script that runs tasks while you sleep.
Copyright © 2026 SparkPlugged Technology Solutions LLC. Licensed under the SparkPlugged Community License.