Find a file
2026-01-13 16:17:44 -05:00
prompts Initial commit 2026-01-13 15:11:25 -05:00
index.js Initial commit 2026-01-13 15:11:25 -05:00
LICENSE Initial commit 2026-01-13 15:11:25 -05:00
manifest.json Initial commit 2026-01-13 15:11:25 -05:00
README.md Update README.md 2026-01-13 16:17:44 -05:00
settings.html Initial commit 2026-01-13 15:11:25 -05:00
style.css Initial commit 2026-01-13 15:11:25 -05:00

🧭 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.0.0

  • Initial Release!

Version License GitHub stars GitHub issues GitHub release

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.

Pathweaver
The Pathweaver bar - Director Mode, 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
  • 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

🎮 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.
🧭 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 (Recommended). 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.

Visual 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.
  • Minimal Mode: Arrow on the bar hides and shows Pathweaver.

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


🌟 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

Pro contributors: Check CONTRIBUTING.md for development setup


📄 License

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


Made with ❤️ for the SillyTavern community