Skip to main content
Ultron doesn’t reset between sessions. Every research output, every confirmed preference, every error and its fix — all of it is stored, organized, and recalled automatically. Memory is what separates Ultron from a stateless chatbot. Agents get smarter with every run. Skills produce better output over time. The more you use Ultron, the more it knows about your business.

What gets stored

~/.ultron/memory/
├── MEMORY.md                        — index file (max 200 lines, 25KB)
├── user_founder_context.md          — your role, background, preferences
├── feedback_email_style.md          — corrections and confirmed patterns
├── project_q2_launch.md             — business context, dates, constraints
├── reference_competitor_acme.md     — research outputs, external pointers
├── feedback_lesson_specter.md       — self-improvement logs from agent errors
└── reference_meeting_prep_linear.md — pre-call briefs, post-call outcomes
Memory entries are plain markdown files. Each is tagged with type, agent, and topic. The index (MEMORY.md) gives Ultron a fast overview of everything stored.

Four memory types

TypeStoresExample
userYour role, background, preferences”I’m a B2B SaaS founder, ICP is Series A CTOs”
feedbackCorrections AND confirmations”Don’t use em-dashes” / “That cold email structure works”
projectNon-code business context”Q2 freeze starts April 15, no new features after that”
referenceResearch outputs, external pointersCompetitive analysis on HubSpot, meeting prep for Stripe
Feedback memory stores both errors and validations. When you confirm something works, Ultron stores that too. This prevents behavior drift — Ultron doesn’t unlearn what’s working.

How memory is used

At the start of every agent turn, a separate Sonnet-powered side-query runs against the memory store. It selects the 5 most relevant entries for the current task. Those entries are injected into context before Kimi K2 sees the message. You don’t manage this. It happens automatically.

Memory Layers

The four memory types and when each is created.

Brain Graph

Visual map of everything Ultron knows about your business.

Memory Recall

How Ultron selects the right memories per turn.

Compression Engine

Three-layer cascade that keeps sessions running indefinitely.