Recallium: From Padawan to Jedi Master

Master your AI's memory in minutes

Try Right Now

Get value in 60 seconds. Copy-paste these prompts:

1
recallium→ Loads your full project context
2
"Remember we chose Postgres because..."→ Stores a decision
3
"Scan this codebase, document each component, design, and flows in my memories"→ Stores a series of memories for later
4
"What did we decide about the database?"→ Retrieves it instantly

Quick Reference

What You WantWhat to Say
Load contextrecallium
Save a decision"Remember we chose X because Y"
Find past work"Search my memories for auth flow"
Search uploaded docs"Search my documents for the API spec"
Resume work"Where did we leave off?"
Find patterns"What bugs keep recurring?"
Think through a problem"Help me think through X vs Y"
Track a follow-up"Create a task: migrate endpoints"
End of day"Summarize what we did today and save it"

Daily Workflows

The 5 things you'll use every day.

Store Decisions & Code

You:

"Remember this JWT implementation. Access tokens expire
in 15 minutes, refresh tokens in 7 days, stored in
HTTP-only cookies."

AI:

✓ Stored with type: code-snippet
   Files: src/auth/jwt.ts
   Tags: authentication, jwt, security

Recall Past Decisions

You:

"What did we decide about database choice?"

AI:

We chose MongoDB for user preferences because:
- Schema flexibility for custom fields
- Nested documents for preference hierarchies
- Team has more MongoDB experience

Check File Context Before Editing

You:

"I'm about to edit src/auth/jwt.ts. What should I know?"

AI:

Found 3 relevant memories:
1. JWT Refresh Implementation (2 weeks ago)
2. Bug Fix: Race Condition (1 week ago)
3. Security Enhancement (3 days ago)

⚠️ Token reuse detection is sensitive -
   test thoroughly if modifying refresh flow.

Search All Your Work

You:

"Show me everything we've done on authentication"

AI:

Found 8 memories:
- 3 implementations (JWT, OAuth2, 2FA)
- 2 decisions (JWT over sessions, 15min expiry)
- 2 bug fixes (race condition, CORS)
- 1 performance improvement (45ms → 8ms)

Resume After a Break

You:

"Where did we leave off?"

AI:

Last session (2 hours ago):
- Implemented rate limiting for login endpoint
- Created task: "Add integration tests for auth"
- Pending: Review PR for token rotation fix

Ready to continue?

Power User Workflows

Advanced features for deeper insights.

Pattern Detection

You:

"What patterns have emerged in our API error handling?"

AI:

Analyzing 23 memories across 4 projects...

Common Patterns:
1. Centralized Error Middleware (3 projects)
2. Domain-Specific Exceptions (strong pattern)
3. Circuit Breaker for External APIs (emerging)

Recommendation: Standardize on patterns 1+2.

Bug Root Cause Analysis

You:

"Why do we keep having authentication bugs?"

AI:

Quality Analysis:

Root Causes:
1. Race Conditions (3 occurrences) ⚠️
2. Token Expiry Edge Cases (2 occurrences)
3. CORS Misconfigurations (2 occurrences)

Recommendation: Add integration tests for
concurrent auth scenarios (40% of bugs).

Structured Thinking

You:

"Help me think through migrating from REST to GraphQL"

AI:

🤔 Starting structured thinking...

Branch 1: Big Bang Migration
- Risk: HIGH, Timeline: 3-4 months

Branch 2: Gradual Migration (Facade)
- Risk: MEDIUM, Timeline: 6-8 months

Branch 3: New Features Only
- Risk: LOW, Timeline: Ongoing

Recommendation: Branch 2 - proves value
incrementally, team learns while productive.

Task Tracking with Context

You:

"Remind me to add rate limiting. Link to our auth work."

AI:

Task created: "Add rate limiting to login"

Linked to:
- Memory #1234: JWT implementation
- Memory #1245: Auth bug fix

Full context available when you return!

Multi-Tool & Multi-Project

One memory layer across all your tools and projects.

Cross-Project Insights

You:

"What authentication patterns work best across all my projects?"

AI:

Analyzing 5 projects...

Strongest patterns:
1. JWT + refresh rotation (4 projects, 0 issues)
2. Redis session store (3 projects, stable)
3. RBAC middleware (2 projects, scaling well)

Avoid: Cookie-only auth caused CORS issues in 2 projects.

Unified Context Across IDEs

You:

"What did I work on yesterday? I used VS Code in the morning
and Cursor in the afternoon."

AI:

Yesterday's work (both IDEs):

Morning (VS Code):
- Fixed auth middleware bug
- Added rate limiting research

Afternoon (Cursor):
- Implemented rate limiter based on research
- Created task: "Add rate limit tests"

All context unified regardless of which tool you used.

Build the Habit

Recallium's value compounds over time. Build these rituals:

Start of Session
recallium
Loads rules, recent work, project context
After Finishing Work
"Save what we just did: [describe changes]"
Captures implementation while fresh
End of Day
"Summarize what we accomplished and save it"
Creates session summary for next time
After a Break
"Where did we leave off?"
Instant context restoration
Before Editing a File
"What context do we have for [filename]?"
Surfaces past decisions, warnings, bugs

5 Rules for Effective Memory

1
Always search before editing a file

Your AI will find past implementations, warnings, and decisions you've forgotten.

2
Consolidate — save once after completing work

Don't save after every line. One comprehensive memory beats ten fragments.

3
Be specific — "chose X because Y" beats "chose X"

Future you needs the reasoning, not just the decision.

4
Include file paths when saving code work

Makes memories searchable by file — critical for "before editing" workflow.

5
Save important work before moving on

If you solved something hard, save it. Your AI can't remember what you don't tell it.

Troubleshooting

"AI isn't remembering things"

✗ Vague:"Save this"
✓ Explicit:"Remember this JWT implementation with refresh token rotation"

Look for the AI's confirmation: "✓ Stored with type: ..."

"Search returns nothing"

✗ Too specific:"getUserByIdAndValidateToken"
✓ Broader:"Search my memories for user authentication"

Semantic search finds related concepts — use natural language.

"Found wrong context"

✗ Ambiguous:"Find my work"
✓ Specific:"Find my authentication work in the payment-service project"

Include project name and topic for precise results.

"Too many search results"

✗ Broad:"Show me everything"
✓ Filtered:"Find recent authentication decisions in src/auth/"

Use filters: recent_only, memory_type, file_path.

You're Ready!

Start with the 60-second quick win, then build the daily habits. Your AI will get smarter with every session.