Your Codebase Gets
Smarter Every Session.
Milens is the only code intelligence tool that learns. Agents annotate discoveries. Milens remembers. Over time, patterns evolve into permanent rules.
Three steps. Your codebase learns.
Every AI agent session becomes a learning opportunity. Discoveries are saved, recalled, and eventually promoted to permanent rules.
Annotate
Agent discovers a bug, quirk, or pattern during a session. Saves it with a confidence score via annotate({symbol, key, value}). The observation persists across all future sessions.
Recall
Next session, the agent auto-retrieves all annotations. “I know createUser() has a bug—call normalizeEmail() first.” Agents avoid repeating past mistakes.
Evolve
High-confidence patterns (≥0.9) are promoted to permanent .agents/skills/*.md files via milens evolve. Now enforced as rules for every agent, every session.
Watch the learning loop in action.
From a single annotation to an enforced rule — here’s how Milens turns agent discoveries into permanent codebase intelligence.
value: "Must call normalizeEmail() before createUser()"})
✓ Annotated. Confidence: 0.5
SESSION 2 $ recall({symbol: "createUser"})
⚠ Known issue: "Must call normalizeEmail() before createUser()"
Agent avoids the bug. Confidence ↑ 0.7
SESSION 5 Confidence reaches 0.9
$ milens evolve
✓ Promoted to .agents/skills/milens-bug/SKILL.md
✓ Now enforced for ALL future sessions.
How confidence builds over time.
Every annotation starts with a confidence score. As it’s corroborated across sessions, the score rises—and high-confidence patterns get promoted to permanent rules.
Noted
Agent noticed something worth remembering. Might be useful in future sessions. Low confidence means the agent will mention it but won’t act on it aggressively.
Corroborated
Multiple agents or sessions have confirmed the pattern. It’s likely important. Agents will actively warn before touching the affected symbol. Confidence rises with each corroboration.
Proven
The pattern has been confirmed across enough sessions that it qualifies as a permanent rule. Auto-promoted to .agents/skills/*.md via milens evolve. Now enforced automatically.
Automate the evolution.
Don’t remember to run evolve. Schedule it once and let Milens handle the rest.
Once scheduled, Milens checks annotations weekly. Any symbol whose confidence reaches 0.9 is automatically promoted. Your codebase evolves without anyone lifting a finger.
Not just indexed. Learned.
Milens is the only code intelligence tool with memory. Annotations persist across sessions. Patterns evolve into rules. Your codebase gets smarter every time an agent touches it.
Start Learning