Memory System

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

Layer	Location	Scope
Global	`~/.config/lukan/memory.md`	All projects
Project	`.lukan/memory.md`	Specific project
LUKAN.md	Project root	Auto-generated project context

All memory layers are combined into the system prompt automatically.

CLI

Configuration

Extensions

Advanced

LUKAN.md (Project Guide)

Project Memory

Global Memory

Compaction

Memory Layers

​LUKAN.md (Project Guide)

​Project Memory

​Global Memory

​Compaction

​Memory Layers

LUKAN.md (Project Guide)

Project Memory

Global Memory

Compaction

Memory Layers