Emma

Helper for local development of SillyTavern extensions.

Create new UI extensions from SillyTavern and open in your code editor for editing. Breaking your user interface has never been easier!

Real features

• Creates new local extensions
• Adds some starter code to the extension
• Opens the extension for editing in your IDE with a single click!
• Sorts the installed extensions list in various ways

Imaginary features

• Clone a starter template for a new extension
• Convert local-only extensions to distributable, updatable extensions
• Convert shallow git clones of installed extensions to full editable copies
• Configure the extension's manifest
• Extension tagging and categorisation
• Button to prompt Coding Sensei to just write the extension for you

Configuration

Find "Emma" in the extensions panel.

• Enabled: whether Emma is enabled.
• Editor: the shell command that launches your IDE.
• GitHub username: your GitHub username, if any. Used to set the homePage field in the extension's manifest so that when the time comes, you can publish your extension.
• Extensions Base Path: the path to the scripts/extensions/third-party directory in your SillyTavern installation. Only used for the "no auto-open" fallback.

Usage

• New extension: Click the "[Cube] New extension" button in the Extensions panel. Fill in the form:
  • Extension ID: the name of the extension's directory.
  • Display Name: the name of the extension as shown in the Extensions panel, for display_name in the manifest.
  • Author: your name or handle, for author in the manifest and user.name in git.
  • Email (optional): your contact email, if any, for author in the manifest and user.email in git.
• Edit extension: Click "[Cubes] Manage extensions" in the Extensions panel, then click the folder icon next to the extension you want to edit.
  • Auto-open: will run the IDE command to open the extension in your IDE.
  • No auto-open: will open a dialog with the path and IDE command to copy.
• Sort extensions: Click "[Cubes] Manage extensions" in the Extensions panel, then use the dropdown to sort as desired.

Requirements

SillyTavern 1.12.8 and above.

How to install

Use this URL with the extension installer:

https://github.com/ceruleandeep/SillyTavern-Emma

Creating new extensions and single-click editing requires the server plugin to also be installed.

Just Webstorm Things

• For the love of gods, edit your extension by opening the main SillyTavern directory in Webstorm, not the extension directory.
• If you don't have webstorm in your path, they moved that configuration into Toolbox, go look there.
• Register your extension as a VCS root in Webstorm to enable version control features (Settings -> Version Control -> Directory Mappings, find the unregistered root, click +).

Licence

AGPLv3