Eyra has three local context sources:
  • Compact durable memory through mcp-prose-memory.
  • ~/.config/eyra/AGENTS.md for rules and instructions.
  • ~/.config/eyra/personality.md for tone and personality.
All three are local. They are also budgeted before model calls. This is intentional: local models have limited context, so Eyra stores and injects small facts instead of raw transcripts.

​
Normal use

Check memory: 
eyra memory status
eyra memory show
Save one fact: 
eyra memory remember "I prefer short answers"
Inside Eyra: 
/memory status
/memory remember I prefer short answers
/memory show
/memory forget short answers
You can also say: 
Remember that I prefer short answers.
What do you remember?
Forget short answers.

​
What gets saved

Eyra stores compact key/value facts. A long sentence is reduced before it reaches memory. Example: 
answer_style: Prefers concise answers
Eyra refuses to save raw conversations, secrets, screenshots, clipboard dumps, stack traces, PDF text, connector payloads, and long tool outputs. Explicit memory requests save immediately:
  • eyra memory remember "I prefer short answers"
  • /memory remember I prefer short answers
  • Remember that I prefer short answers.
Automatic saves are narrower. Eyra may save short preference/profile facts from ordinary turns when MEMORY_AUTO_SAVE_ENABLED=true. If you want stricter control, set: 
MEMORY_WRITE_REQUIRE_CONFIRMATION=true
With that setting on, ordinary automatic saves are skipped. Direct remember commands still save because you asked for that exact write.

​
Files

eyra setup creates these files if they do not exist: 
~/.config/eyra/AGENTS.md
~/.config/eyra/personality.md
Use AGENTS.md for rules: 
- Keep answers short unless I ask for detail.
- Use real local tools instead of guessing.
Use personality.md only for style: 
Warm, calm, direct, and lightly playful.
Do not paste long manuals into either file. Eyra clips AGENTS.md to AGENTS_MAX_CHARS and personality.md to PERSONALITY_MAX_CHARS.

​
Settings

MEMORY_ENABLED=true
MEMORY_AUTO_SAVE_ENABLED=true
MEMORY_PATH=~/.mcp-prose-memory/memory.json
MEMORY_CONTEXT_MAX_CHARS=1500
MEMORY_FACT_MAX_CHARS=220
MEMORY_WRITE_REQUIRE_CONFIRMATION=false
AGENTS_FILE=~/.config/eyra/AGENTS.md
AGENTS_MAX_CHARS=1200
PERSONALITY_FILE=~/.config/eyra/personality.md
PERSONALITY_MAX_CHARS=800
Disable memory: 
eyra memory off
Turn it back on: 
eyra memory on

​
Dependency

Eyra uses mcp-prose-memory underneath. Setup and the installer try to install it for you. To repair it manually: 
npm install -g mcp-prose-memory || npm install -g https://github.com/gabrimatic/mcp-prose-memory/releases/download/v3.1.0/mcp-prose-memory-3.1.0.tgz
eyra doctor
The installer uses the same fallback when npm authentication or registry access is unavailable. If memory is unavailable, Eyra can still answer without memory. eyra doctor will show the repair step. eyra doctor checks more than whether the command exists. It starts the memory MCP server and asks for a small compact context, so missing commands, MCP startup failures, and memory-file errors show as separate repair states.