PersistentGuides

Persistent Guides Menu

Persistent guides are context snippets injected into the chat that persist across multiple turns. They help the AI maintain awareness of key details such as the current situation, character thoughts, clothing, position, rules or custom user instructions. The persistent guides menu opens a popup with buttons to generate or manage these guides.

Opening the Persistent Guides Menu

Click the compass/scroll icon next to the send button to open the persistent guides menu. The menu lists guide types and management actions.

Guide Types

Each guide type creates a persistent injection with an identifier (ID). Guides can be regenerated or edited at any time.

Situational

Generates context summarizing recent chat events or a user‑specified focus. It uses the /gen command to summarise the last few messages and injects the result as the situation guide. Use this when you want the AI to recall the current scene or conversation state.

Thinking

Produces an out‑of‑character thought from the character’s perspective, giving insight into their inner feelings. It uses the SysThinking guide (ID thinking) and can be triggered automatically after each AI reply if enabled in settings.

Clothes

Describes the characters’ outfits and appearance. It uses the SysClothes guide (ID clothes) and can be auto‑triggered after each AI reply.

State

Details the characters’ positions, physical state or status. It uses the SysState guide (ID state) and can be auto‑triggered.

Rules

Generates or updates a list of explicit in‑story rules. It calls /gen with a temporary system preset and injects the result as rule_guide. Use this to maintain story constraints or session rules.

Custom

Allows you to write your own context manually. It opens a large text box where you can enter any guidance, then injects it under the Custom ID. This is useful for notes, reminders or house rules that aren’t covered by other guides.

Fun Prompts

Provides a selection of creative prompts from a menu such as “Shocking Plot Twist” or group‑chat commentary. When you choose a fun prompt the extension loads the corresponding text from funPrompts.txt and executes it using the same model switching and guide infrastructure. It is great for spicing up the story with unexpected events.

Tracker

The tracker runs automatically before each message to monitor a quantitative aspect of your story. You can configure the tracker in a popup – set how many recent messages to scan, the initial format, a guide prompt (what to look for) and a tracker prompt (how to update the tracker). Once enabled it will:

1. Analyze recent chat messages to extract information.
2. Update a persistent tracker note with the new data.

This feature is ideal for tracking things like character movement, relationship scores or other numerical values that evolve over time.

Management Actions

After you have created guides you can manage them from the bottom of the persistent guides menu:

• Edit Guides: Opens a popup listing all active guides. Select a guide to edit its text and reinject it. This uses /listinjects and /input commands.
• Show Guides: Displays all active guide injections in a popup without editing.
• Flush Guides: Lists active guides and allows you to remove selected ones or all guides using /flushinjects. Use this to clear outdated context.

Auto‑Triggers

You can enable automatic triggering of the Thinking, Clothes, State and Custom Auto guides in the settings panel. When enabled the corresponding guide will run after every AI message. Auto‑triggered guides help keep context up to date without manual intervention.

Using Persistent Guides

1. Open the menu: Click the persistent guides button.
2. Choose a guide type:
   • For Situational, you may be asked to provide a focus (optional) and the extension will summarise the recent chat.
   • For Thinking, Clothes or State, the guide runs immediately.
   • For Rules, it will ask for any topics to include.
   • For Custom, a text box appears where you can write your own context.
   • For Fun or Tracker, follow the instructions in the pop‑up.
3. The generated guide will be injected and persist until you flush or edit it.
4. Use the management actions to edit, view or remove guides as needed.

Tips

• Use situational guides when the conversation moves to a new scene or when the AI seems to lose track of earlier events.
• Keep the thinking, clothes and state guides concise; they should provide relevant details without overwhelming the model.
• Remember to flush guides when they are no longer relevant to avoid conflicting context.