agent-zero/plugins/_memory
frdel 93d1131ce1 Unify WebUI icons and fix message collapsing
Introduce the x-icon custom element and migrate first-party WebUI and bundled plugin markup while retaining legacy Material icon compatibility. Defer icon-font readiness until the splash-installed document is parsed so Firefox does not leave icons transparent. Centralize chat message collapse handling, avoid false Show More controls on short user messages, and align grouped-message pagination styling. Update DOX and add regression coverage for the icon and collapse behavior.
2026-07-31 13:32:41 +00:00
..
api Refactor: use user locale for time displays 2026-05-21 15:26:00 +02:00
extensions Unify WebUI icons and fix message collapsing 2026-07-31 13:32:41 +00:00
helpers Improve auto-memory extraction quality 2026-06-02 09:42:47 +02:00
prompts Guide memory staleness with timestamps 2026-06-02 11:13:41 +02:00
tools Coerce memory load numeric args 2026-07-02 17:29:40 +02:00
webui Unify WebUI icons and fix message collapsing 2026-07-31 13:32:41 +00:00
AGENTS.md Coerce memory load numeric args 2026-07-02 17:29:40 +02:00
default_config.yaml refactor - plugin names and builtin plugins 2026-03-10 22:20:53 +01:00
plugin.yaml refactor - plugin names and builtin plugins 2026-03-10 22:20:53 +01:00
README.md Improve auto-memory extraction quality 2026-06-02 09:42:47 +02:00

Memory

Provide persistent vector-based memory and knowledge retrieval for Agent Zero.

What It Does

This plugin stores memories and knowledge embeddings in a FAISS-backed vector database, exposes tools for saving and recalling memories, and provides APIs and UI support for browsing, importing, updating, and deleting memory entries.

Main Behavior

  • Persistent vector store
    • Creates and loads FAISS indexes per memory subdirectory.
    • Stores embedding metadata so the index can be rebuilt if the embedding model changes.
  • Knowledge preloading
    • Loads configured knowledge directories into memory when a database is initialized.
  • Memory tools
    • Includes tools for saving, loading, deleting, forgetting, and behavior adjustment workflows.
  • Automatic conversation memory
    • Stores durable preferences, project facts, and recurring constraints while filtering transient action-history fragments before insertion.
  • Dashboard APIs
    • Exposes search, delete, bulk delete, update, and subdirectory listing endpoints for the memory dashboard.
  • Scoped storage
    • Supports different memory subdirectories so memory can be separated by context or agent scope.

Key Files

  • Core memory engine
    • helpers/memory.py implements FAISS storage, index loading, embedding configuration, and knowledge preload.
  • Knowledge import
    • helpers/knowledge_import.py imports external knowledge into memory storage.
  • Consolidation
    • helpers/memory_consolidation.py contains memory consolidation logic.
  • Tools
    • tools/memory_save.py
    • tools/memory_load.py
    • tools/memory_delete.py
    • tools/memory_forget.py
    • tools/behaviour_adjustment.py
  • API
    • api/memory_dashboard.py powers the memory management dashboard.
    • api/import_knowledge.py and api/knowledge_reindex.py handle knowledge import and reindexing.

Configuration Scope

  • Settings section: agent
  • Per-project config: true
  • Per-agent config: true

Plugin Metadata

  • Name: _memory
  • Title: Memory
  • Description: Provides persistent memory capabilities to Agent Zero agents.