Skip to content

Folder Memory

By Fu-Jie ¡ v0.1.0 ⭐ Star this repo
followers points top contributions downloads saves views

Folder Memory is an intelligent context filter plugin for OpenWebUI. It automatically extracts consistent "Project Rules" from ongoing conversations within a folder and injects them back into the folder's system prompt.

Install with Batch Install Plugins

If you already use Batch Install Plugins from GitHub , you can install or update this plugin with:

Install plugin from Fu-Jie/openwebui-extensions

When the selection dialog opens, search for this plugin, check it, and continue.

[!IMPORTANT] If the official OpenWebUI Community version is already installed, remove it first. After that, Batch Install Plugins can keep this plugin updated in future runs.

đŸ”Ĩ What's New in v0.1.0

  • Initial Release: Automated "Project Rules" management for OpenWebUI folders.
  • Folder-Level Persistence: Automatically updates folder system prompts with extracted rules.
  • Optimized Performance: Runs asynchronously and supports PRIORITY configuration for seamless integration with other filters.

✨ Core Features

  • Automatic Extraction: Analyzes chat history every N messages to extract project rules.
  • Non-destructive Injection: Updates only the specific "Project Rules" block in the system prompt, preserving other instructions.
  • Async Processing: Runs in the background without blocking the user's chat experience.
  • ORM Integration: Directly updates folder data using OpenWebUI's internal models for reliability.

Installation & Configuration

1) Installation

  1. Copy folder_memory.py to your OpenWebUI plugins/filters/ directory (or upload via Admin UI).
  2. Enable the filter in your Settings -> Filters.
  3. Prerequisite: Conversations must occur inside a folder (create a folder and start a chat within it).

2) Configuration (Valves)

Valve Default Description
PRIORITY 20 Priority level for the filter operations.
MESSAGE_TRIGGER_COUNT 10 The number of messages required to trigger a rule analysis.
MODEL_ID "" The model used to generate rules. If empty, uses the current chat model.
RULES_BLOCK_TITLE ## 📂 Project Rules The title displayed above the injected rules block.
SHOW_DEBUG_LOG False Show detailed debug logs in the browser console.
UPDATE_ROOT_FOLDER False If enabled, finds and updates the root folder rules instead of the current subfolder.

⭐ Support

If this plugin has been useful, a star on OpenWebUI Extensions is a big motivation for me. Thank you for the support.

🛠ī¸ How It Works

Folder Memory Demo

  1. Trigger: When a conversation reaches MESSAGE_TRIGGER_COUNT (e.g., 10, 20 messages).
  2. Analysis: The plugin sends the recent conversation + existing rules to the LLM.
  3. Synthesis: The LLM merges new insights with old rules, removing obsolete ones.
  4. Update: The new rule set replaces the <!-- OWUI_PROJECT_RULES_START --> block in the folder's system prompt.

⚠ī¸ Notes

  • This plugin modifies the system_prompt of your folders.
  • It uses a specific marker <!-- OWUI_PROJECT_RULES_START --> to locate its content. Do not manually remove these markers if you want the plugin to continue managing that section.

đŸ—ēī¸ Roadmap

See ROADMAP.md for future plans, including "Project Knowledge" collection.

Changelog

See the full history on GitHub: OpenWebUI Extensions