SillyTavern-Pathweaver/README.md
2026-03-06 10:12:47 -05:00

11 KiB

🧭 Pathweaver for SillyTavern

Elevate your stories and roleplays from good to unforgettable. Pathweaver injects fresh ideas, unexpected twists, and genre-perfect moments exactly when you need them, making every session feel like a professionally crafted story.

🆕 What's New

ver 1.5.0

  • New setting: Reasoning Mode. Increases max tokens and properly handles thinking tags.
  • Reasoning Mode allows for setting the max output token

ver 1.4.6

  • Added delay and safeguards for Surprise Me feature to prevent KoboldCPP from crashing

ver 1.4.5

  • (Mobile) Fixes button menus not working
  • (Mobile) Shifted buttons to the right to fix issues of them disappearing, removed 'Pathweaver' title
  • Fixed issue where settings weren't being saved

Version License GitHub stars GitHub issues

Pathweaver is a creative companion extension for SillyTavern. It analyzes your current chat context and generates Suggestions — options for where the story could go next. Whether you need a sudden plot twist, a new character introduction, or just a little nudge to break writer's block, Pathweaver provides up to 6 distinctive suggestions for every request.


The Pathweaver bar - Director Mode, Surprise Me, Context-Aware, Plot Twist, New Character, Explicit, Custom, and Genre suggestions.


Key Features

🎯 Smart Generation

  • Context-Aware: Analyzes 2-10 messages for coherent suggestions
  • Director Mode: Single Scene or Story Beats for precise control
  • Surprise Me: Adds a hidden suggestion that triggers later in the story/roleplay
  • Genre Specialization: 9 built-in genres + unlimited custom styles

⚙️ Flexible & Powerful

  • Multiple Backends: Main API, Connection Profiles, Ollama, OpenAI-compatible
  • Responsive Design: Works on desktop, tablets, and smartphones
  • Seamless Integration: Glass UI design matches SillyTavern perfectly

Pathweaver - Settings
Each card with option to Copy (copies to clipboard), Insert (add to SillyTavern's input but doesn't send) or Send (immediately sends to the AI.)


🎮 How It Works

Pathweaver adds a Control Bar above your chat input. Click any button to instantly generate up to 6 suggestions.

The Categories

Icon Category Usage
🎬 Director Opens a simplified input box. You type a prompt, AI gives you tailored suggestions.
😲 Surprise Me Secretly injects a suggestion into context a set number of messages before it triggers.
🧭 Context-Aware "What happens next?" Smart suggestions based on story logic and context.
🔀 Plot Twist Throws a curveball. Unexpected events, betrayals, and shocks.
👤+ New Character Adds a new character to the story based on a variety of character tropes.
🔥 Explicit (Optional) NSFW Spicy suggestions. Only one hand needed.
🎭 Genres A dropdown menu with specific genre flavors: Horror, Romance, Sci-Fi, etc.
📚 Custom Create custom suggestions, such as genre mashups like "Cyberpunk-Noir" or "Cozy-Horror".

Pathweaver - Director Mode
Direct your next scene with Single Scene or Story Beat modes.


🛠️ Installation

  1. Open SillyTavern and click the Extensions button (puzzle piece icon)
  2. Select Install Extension
  3. Paste this URL:
    https://github.com/mattjaybe/SillyTavern-Pathweaver
    
  4. Click Install and refresh SillyTavern

🚀 Quick Start

  1. Install the extension (see Installation above)
  2. Refresh SillyTavern - You'll see the Pathweaver bar appear above your chat input
  3. Start a conversation with any character
  4. Click any button on the bar (try 🧭 Context-Aware first!)
  5. Pick a suggestion and watch your story unfold

That's it! Pathweaver works with your existing API setup - no additional configuration needed.


⚙️ Configuration

Access Pathweaver settings by clicking the ⚙️ gear icon on the right side of the Pathweaver bar or in SillyTavern's extension menu.

Generation Engine

Engine Description
Main (API) Uses your currently active SillyTavern API. Easiest setup.
Connection Profile Recommended. Select a Connection Profile saved in SillyTavern.
Ollama Connect directly to a local Ollama instance (default: http://127.0.0.1:11434).
OpenAI Compatible Connect to KoboldCPP, LM Studio, vLLM, or other OpenAI-compatible endpoints.

Settings

  • Show Explicit: Toggle the visibility of the "Explicit" (Fire icon) category.
  • Button Size: Compact, Default, or Max.
  • Font Size: Adjust the size of the text from Small, Default, or Large.
  • Title Font: Change the font of 'Pathweaver' on the bar, or hide it altogether.
  • Stream Suggestions: Cards appear in real-time as each suggestion is generated.
  • Minimal Mode: Arrow on the bar hides and shows Pathweaver.
  • Surprise Me: Set whether to randomize the message away amount or manually set it.

Pathweaver - Settings
Quickly and easily adjust the Pathweaver settings to your preferences.


My Other SillyTavern Extensions: EchoChamber & Larson

EchoChamber

EchoChamber is a powerful extension that generates a live reaction feed alongside your story. Whether it's a salt-fueled Discord chat, a viral Twitter feed, dramatic breaking news, or a sarcastic MST3K roasting session—EchoChamber immerses you in the world with AI-generated audience reactions.

Pathweaver - Settings
Quickly and easily adjust the Pathweaver settings to your preferences.

Larson

Larson is a beautiful animated status bar for SillyTavern with 8 unique styles (Gradient, Breathe, Pulse, Cylon, Segment, Glitch, Liquid, Convergence). Independent animations for Generating/Thinking/Idle states, custom theme creator, mobile-optimized UI, and smart LLM thinking detection.


🌟 Extras

🎨 EyeCare Theme

The screenshots use a custom high-contrast theme optimized for readability. Copy the JSON below and save as a .json file to import into SillyTavern:

Click to view Theme JSON
{
    "name": "EyeCare",
    "blur_strength": 0,
    "main_text_color": "rgba(230, 240, 255, 1)",
    "italics_text_color": "rgba(150, 220, 255, 1)",
    "underline_text_color": "rgba(255, 200, 100, 1)",
    "quote_text_color": "rgba(180, 255, 180, 1)",
    "blur_tint_color": "rgba(15, 20, 28, 1)",
    "chat_tint_color": "rgba(15, 20, 28, 1)",
    "user_mes_blur_tint_color": "rgba(22, 28, 38, 1)",
    "bot_mes_blur_tint_color": "rgba(18, 24, 32, 1)",
    "shadow_color": "rgba(0, 0, 0, 1)",
    "shadow_width": 0,
    "border_color": "rgba(70, 100, 140, 1)",
    "font_scale": 1,
    "fast_ui_mode": true,
    "waifuMode": false,
    "avatar_style": 2,
    "chat_display": 1,
    "toastr_position": "toast-top-right",
    "noShadows": true,
    "chat_width": 50,
    "timer_enabled": false,
    "timestamps_enabled": true,
    "timestamp_model_icon": true,
    "mesIDDisplay_enabled": false,
    "hideChatAvatars_enabled": false,
    "message_token_count_enabled": false,
    "expand_message_actions": true,
    "enableZenSliders": false,
    "enableLabMode": false,
    "hotswap_enabled": false,
    "custom_css": "",
    "bogus_folders": false,
    "zoomed_avatar_magnification": false,
    "reduced_motion": true,
    "compact_input_area": false,
    "show_swipe_num_all_messages": false,
    "click_to_edit": false,
    "media_display": "list"
}

Explore Pathweaver with the custom-made Real Talk Podcast story:

Real Talk Podcast Card

Right-click & Save to import

The Story:
Victoria Cross, 38, built her podcast empire dissecting male mediocrity and modern dating's failures—until Daniel, 18, calls in and systematically dismantles her worldview on air. Their explosive debates accidentally spark the "New Pond Movement," urging older women to pursue younger men and leave the "stagnant pond" behind.

Import Options:


🤝 Contributing

Love Pathweaver? Here's how you can help:

  • Star this repo to show support
  • 🐛 Report bugs via Issues
  • 💡 Request features you'd love to see
  • 🎨 Share custom styles with the community (Discussion)
  • 🔧 Submit PRs for improvements
  • 📣 Spread the word and tell your friends about Pathweaver

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.


Made with ❤️ for the SillyTavern community