Best Practices
Step-by-step workflows to get the most out of EON Memory.
No technical knowledge required. Just follow the steps.
New here? Take the guided tour
A 60-second walkthrough of all key features.
1. Setting up a new project
You just created a new project and want your AI to understand it from the start. Follow these 4 steps in order:
Step 1: Create the project
Go to the Projects page in your dashboard and click “Create Project”. Give it a clear name (e.g. “my-webapp” or “client-api”). This name will be used to organize all your memories.
Step 2: Deep Scan your codebase
Open Claude Code in your project folder and paste this prompt. It will read every important file and create a memory for each one. After this, your AI knows your entire codebase.
Paste into Claude Code. Takes 2-10 minutes depending on project size.
Scan my entire project and create detailed memories for every important file. For each file, create a memory with: - Title: "[filename] - [what it does in one line]" - Content: Full description including imports, exports, functions, classes, and how it connects to other files - Category: "context" - Project: Use the current project name Start with the most important files first (entry points, config, main modules). Skip: node_modules, .git, build outputs, lock files, images. Use eon_scan if available, otherwise use eon_create for each file.
Step 3: Create a roadmap
Now that your AI knows the code, ask it to create a roadmap. This gives you and your AI a shared plan of what needs to happen next.
Paste into Claude Code. Creates a roadmap memory for your project.
Create a project roadmap based on everything you know about this project.
Step 1: Search existing memories with eon_search("roadmap milestone goal plan")
Step 2: Analyze the codebase structure
Step 3: Create a roadmap memory with:
- Title: "Project Roadmap - [Project Name]"
- Category: "roadmap"
- Content should include:
- Current state (what exists, what works)
- Short-term goals (this week)
- Medium-term goals (this month)
- Known issues and tech debt
- Dependencies and blockers
Save it with eon_create.Step 4: Verify
Go to your Projects page and click on your project. You should see all the memories that were created. Check that:
- • Each important file has its own memory
- • The roadmap memory exists with clear goals
- • Quality tiers are mostly Silver or Gold
2. Adding EON to an existing project
You already have a project with code and want to start using EON Memory. The process is the same as a new project, but with one extra consideration:
Quick start (5 minutes)
- 1. Open your project folder in the terminal
- 2. Run:
npx eon-memory init - 3. Enter your API key when asked (get it from Settings)
- 4. Open Claude Code in the same folder
- 5. Say: “Run eon_health to check the connection”
- 6. If it says “OK” — you're ready. Run the Deep Scan prompt from Step 2 above.
What happens after the Deep Scan?
Your AI now has detailed knowledge of every file in your project. In the next session, it will automatically search its memories before answering your questions. You don't need to explain your codebase again — it remembers.
3. Daily workflow
Follow this simple routine every day to keep your AI's memory sharp and useful:
| When | What to do | How |
|---|---|---|
| Start of day | Check that everything is connected and review your stats | Health Check button on Memories page |
| During work | When you make an important decision or learn something new, tell your AI to save it | Say: “Save a memory about [what happened]” |
| End of day | Merge today's short notes into clean, structured knowledge | Consolidation button on Memories page |
Tip: You don't need to save everything. Focus on decisions (“we chose X because Y”), errors (“this broke because Z”), and context (“the client wants A not B”).
4. Weekly maintenance
Once a week, spend 5 minutes cleaning up your memories. This keeps your AI fast and accurate:
Deep Consolidation
This merges all your short memories from the past week into a few comprehensive ones. Instead of 30 small notes, you get 5 well-structured reference documents.
Paste into Claude Code once per week.
Review my recent memories and consolidate them into structured knowledge. Step 1: Load recent memories with eon_list (limit: 30) Step 2: Group them by topic or feature Step 3: For each group, create ONE consolidated memory that combines: - What was done (facts) - Why it was done (decisions) - What was learned (lessons) - What is still open (next steps) Step 4: Save each consolidated memory with eon_create (category: "context") This reduces clutter and creates high-quality reference memories.
Review quality scores
Go to your Memories page. Look at the quality tier badges:
- • Gold — Excellent. No action needed.
- • Silver — Good. Could be improved with more detail.
- • Bronze — Too vague. Add file paths, function names, or reasons.
- • Review — Needs attention. Consider rewriting or deleting.
5. Writing high-quality memories
The difference between a useful memory and a useless one is detail. Here are the rules:
Bad memories
- “Fixed the login bug”
- “15 API routes exist”
- “Updated the database”
- “Refactored some components”
No detail. In 2 weeks, nobody knows what this means.
Good memories
- “Login bug: session cookie was missing SameSite=Lax, fixed in auth.ts:42”
- “POST /api/vote — session-based, returns {success, count}, 429 on rate limit”
- “Added user_preferences table with 4 columns: id, user_id, theme, language”
- “Split UserProfile into UserAvatar + UserSettings, reduced re-renders by 60%”
Specific. Another AI can act on this immediately.
The golden rule
Ask yourself: “Could another AI use this memory to write code in 6 months?”
If the answer is no, add more detail: file paths, function names, parameter types, error codes, or the reason behind the decision.
6. Using agents
EON comes with optional AI agents that automate common tasks. Install them from the customer package:
All agents are installed automatically
When you run npx eon-memory init, all 3 agents are installed to ~/.claude/agents/ automatically. No manual setup needed.
Jarvis (Orchestrator)
For complex, multi-step tasks. Jarvis searches your memories first, breaks down the work, delegates to the right tools, and saves what was done. Best for: “Build feature X”, “Fix bug Y and write tests”, “Refactor module Z”.
Uses Opus model for highest quality reasoning.
Memory Manager
Manages your EON memories automatically. Creates, searches, updates, and organizes. Best for: “Clean up my memories”, “Find everything about feature X”, “Organize memories by project”.
X-Ethics Reviewer
Reviews your code against the X-Ethics framework (Truth, Freedom, Justice, Service). Generates an alignment score from 0-100%. Best for: code reviews, compliance checks.
Uses Sonnet model for fast reviews.
7. Ready-to-use prompts
These prompts are also available as buttons on your Memories page. Copy any of them and paste into Claude Code:
Health Check
Verifies connection, counts memories, checks quality scores, tests search.
Available as button on the Memories page or via Setup Guide.
Deep Project Scan
Reads every file in your project and creates a detailed memory for each. Use when starting with a new codebase.
Takes 2-10 minutes depending on project size.
Scan my entire project and create detailed memories for every important file. For each file, create a memory with: - Title: "[filename] - [what it does in one line]" - Content: Full description including imports, exports, functions, classes, and how it connects to other files - Category: "context" - Project: Use the current project name Start with the most important files first (entry points, config, main modules). Skip: node_modules, .git, build outputs, lock files, images. Use eon_scan if available, otherwise use eon_create for each file.
Create Roadmap
Analyzes your project and creates a structured plan with goals and milestones.
Creates one roadmap memory per project.
Create a project roadmap based on everything you know about this project.
Step 1: Search existing memories with eon_search("roadmap milestone goal plan")
Step 2: Analyze the codebase structure
Step 3: Create a roadmap memory with:
- Title: "Project Roadmap - [Project Name]"
- Category: "roadmap"
- Content should include:
- Current state (what exists, what works)
- Short-term goals (this week)
- Medium-term goals (this month)
- Known issues and tech debt
- Dependencies and blockers
Save it with eon_create.Weekly Consolidation
Merges short-term memories into clean, structured reference documents.
Run once per week to keep your memory clean.
Review my recent memories and consolidate them into structured knowledge. Step 1: Load recent memories with eon_list (limit: 30) Step 2: Group them by topic or feature Step 3: For each group, create ONE consolidated memory that combines: - What was done (facts) - Why it was done (decisions) - What was learned (lessons) - What is still open (next steps) Step 4: Save each consolidated memory with eon_create (category: "context") This reduces clutter and creates high-quality reference memories.
Need the installation guide?
If you haven't set up EON Memory yet, start with the Setup Guide.