Skip to main content

Module memory

Module memory 

Source
Expand description

Project memory — MEMORY.md / CLAUDE.md read/write. Semantic memory: project context injected into the system prompt.

Memory is stored as human-readable Markdown, loaded from two tiers:

Global (~/.config/koda/memory.md): User-wide preferences and conventions that apply to all projects.

Project-local (first match wins):

  1. MEMORY.md — Koda native
  2. CLAUDE.md — Claude Code compatibility
  3. AGENTS.md — Code Puppy compatibility

Both tiers are concatenated and injected into the system prompt. When Koda writes (auto-memory), it always writes to MEMORY.md.

Functions§

active_project_file
Return which project memory file is active (for display purposes).
append
Write an entry to the project’s memory file.
append_global
Write an entry to the global memory file (~/.config/koda/memory.md).
load
Load memory from both global and project-local sources.