Memory

Airupt maintains a persistent memory store so context carries across conversations and sessions.

How It Works

Memory entries are short text facts stored locally at ~/.airupt/memory/. On each message, Airupt retrieves the most relevant entries using semantic search and injects them into the LLM context.

Auto-Extraction

When memory.auto_extract is true, Airupt automatically extracts facts from conversation:

You: I prefer dark mode and I use a Mac.
Airupt: Got it, I'll remember that.

Extracted: user prefers dark mode, user uses a Mac

Explicit Memory

You can tell Airupt directly what to remember:

Remember that my standup is every weekday at 9am EST.
Forget that I use a Mac.
What do you remember about me?

CLI Commands

# List all memory entries
airupt memory list

# Search memory
airupt memory search "standup"

# Add an entry manually
airupt memory add "Prefers responses in bullet points"

# Delete an entry by ID
airupt memory delete abc123

# Clear all memory
airupt memory clear

Configuration

memory:
  enabled: true
  auto_extract: true
  max_entries: 1000

max_entries is a soft limit. When exceeded, the oldest least-accessed entries are pruned automatically.

Privacy

Memory is stored only on your machine at ~/.airupt/memory/. It is never sent to any server other than your configured LLM provider (as part of conversation context).

To back up or migrate memory:

cp -r ~/.airupt/memory/ /your/backup/path/