Skip to main content
Lukan has a multi-layered memory system that persists context across sessions.

​
LUKAN.md (Project Guide)

Auto-generated project guide from package.json and file tree. Created with /lukan command or lukan init. Loaded into the system prompt.

​
Project Memory

Per-project persistent memory stored in .lukan/memories/MEMORY.md. Updated automatically during compaction (at 50k tokens). 
/memories              Show memory status
/memories activate     Activate project memory
/memories deactivate   Deactivate project memory
/memories add [text]   Update memory with optional instruction

​
Global Memory

Stored at ~/.config/lukan/memory.md. Always included in system prompt regardless of project. Manage with /gmemory. 
/gmemory              View global memory
/gmemory show         View global memory
/gmemory add [text]   Update global memory
/gmemory clear        Clear global memory
Use Alt+M to open the memory viewer overlay in the TUI.

​
Compaction

Automatic context compression at 150k tokens. Keeps the last 10 messages and generates a summary. Memory is updated at 50k tokens. Manual trigger with /compact.

​
Memory Layers

LayerLocationScope
Global~/.config/lukan/memory.mdAll projects
Project.lukan/memory.mdSpecific project
LUKAN.mdProject rootAuto-generated project context
All memory layers are combined into the system prompt automatically.