- JavaScript 89%
- HTML 10.2%
- CSS 0.8%
- Update all GitHub URLs in README badges and installation instructions - Update manifest.json homePage URL and bump version to 2.1.0 - Add 'Cleanup Extension Data' section to README documenting staging-only feature - Add info icon tooltip to persona pronouns heading indicating extension source |
||
|---|---|---|
| src | ||
| templates | ||
| index.js | ||
| LICENSE | ||
| manifest.json | ||
| README.md | ||
| style.css | ||
SillyTavern Pronouns [Extension]
Pronoun management for SillyTavern personas. Set pronouns per persona and use them as macros anywhere in your prompts. Includes a dedicated editor in Persona Management, quick presets, a text replacer tool, and slash commands.
Inspired by and partially ported from SillyTavern PR #4542.
Note
This extension requires the Experimental Macro Engine to be enabled.
Installation
Install using SillyTavern's extension installer from the URL:
https://github.com/SillyTavern/SillyTavern-Pronouns
Features
Pronoun Editor
A dedicated pronoun editor appears directly under the persona description field in Persona Management.
- Five pronoun fields — Subjective, Objective, Possessive Determiner, Possessive Pronoun, Reflexive.
- Quick preset buttons — Fill all fields at once with
She/Her,He/Him,They/Them, orIt/Its. - Info icons — Each field shows a tooltip listing all currently registered macros for that pronoun type.
- Persistent — Pronoun values are stored on the persona descriptor alongside the persona description, so they survive exports and backups.
Macros
Pronouns are available as macros anywhere SillyTavern supports macro substitution.
Primary macros (always available):
| Macro | Pronoun type | Example values |
|---|---|---|
{{pronounSubjective}} |
Subjective | she / he / they |
{{pronounObjective}} |
Objective | her / him / them |
{{pronounPosDet}} |
Possessive determiner | her / his / their |
{{pronounPosPro}} |
Possessive pronoun | hers / his / theirs |
{{pronounReflexive}} |
Reflexive | herself / himself / themselves |
{{pronounVerbBe}} |
Verb-be agreement (English) | is / are |
Shorthand aliases (opt-in, see Settings):
English pronoun words as macros — makes prompts easier to read and write at authoring time.
| Macros | Pronoun type |
|---|---|
{{she}} {{he}} {{they}} |
Subjective |
{{her}} {{him}} {{them}} |
Objective |
{{her_}} {{his_}} {{their_}} |
Possessive determiner (trailing _ avoids collision with {{her}}) |
{{hers}} {{his}} {{theirs}} |
Possessive pronoun |
{{herself}} {{himself}} {{themself}} |
Reflexive |
Text Replacer
Accessible via Extensions → Pronouns → Open pronoun replacer.
Paste any prompt or character card text and the tool automatically swaps matching pronoun words with the correct macros for your active persona. Supports shorthand macros when enabled.
Slash Commands
| Command | Description |
|---|---|
/pronouns-set key=<key> <value> |
Set a single pronoun field for the active persona. Keys: subjective, objective, posDet, posPro, reflexive. |
/pronouns-set-preset <preset> |
Apply a preset to the active persona. Presets: she, he, they, it. |
/pronouns-replace [shorthands] [preset=...] [subjective=...] ... <text> |
Replace pronoun words in text with macros. Uses active persona's pronouns by default. shorthands defaults to the global setting. |
/pronouns-open-replacer [shorthands] [text] |
Open the pronoun replacer popup. Optionally prefill with text; otherwise uses clipboard. |
Settings
Access the extension settings under Extensions → Pronouns in the SillyTavern settings panel.
- Enable shorthand macros — Registers
{{she}},{{him}},{{their_}}, etc. as additional aliases. Makes prompts easier to read and write. Disabled by default.
Platform compatibility toggles (only enable if you plan to use character cards from those platforms without manually updating the macros):
- WyvernChat: capitalized variants — Registers
{{pronounSubjectiveCap}},{{pronounObjectiveCap}}, etc. The lowercase variants and dot-notation are always available without this toggle. - JanitorAI: compatibility macros — Registers
{{sub}},{{obj}},{{poss}},{{poss_p}},{{ref}}.
Cleanup Extension Data
Note
This feature requires the staging branch of SillyTavern.
All extension settings and saved pronouns can be removed via the extensions list or during uninstall.
Platform Compatibility
This extension's primary macros ({{pronounSubjective}} etc.) use the same names as WyvernChat's pronoun placeholders, so most WyvernChat cards work out of the box without any toggle.
Additionally, WyvernChat's older dot-notation ({{pronoun.subjective}}, {{pronoun.objective}}, etc.) is automatically rewritten at runtime — no manual conversion needed.
For cards written specifically for JanitorAI ({{sub}}, {{obj}}, {{poss}}, {{poss_p}}, {{ref}}), enable the JanitorAI compatibility macros toggle in settings.
Terminology
| Term | Description | Examples |
|---|---|---|
| Subjective | Used as sentence subject | she / he / they / it |
| Objective | Used as sentence object | her / him / them / it |
| Possessive determiner | Before a noun | her / his / their / its |
| Possessive pronoun | Stands alone | hers / his / theirs / its |
| Reflexive | Refers back to subject | herself / himself / themselves / itself |
For more information, see pronouns.org or Wikipedia.
Roadmap
- Pronoun editor under Persona Management
- Quick preset buttons (She/Her, He/Him, They/Them, It/Its)
- Primary
{{pronounSubjective}}/{{pronounObjective}}/ etc. macros {{pronounVerbBe}}macro ("is"/"are") for verb agreement- English shorthand macros (
{{she}},{{him}}, etc.) — opt-in toggle - WyvernChat compatibility: lowercase names always on, dot-notation rewritten via pre-processor, capitalized variants opt-in
- JanitorAI compatibility macros (
{{sub}},{{pos}}, etc.) — opt-in toggle - Pronoun text replacer popup with shorthand support
- Slash commands for pronoun management and direct text replacement
- Add support for character pronouns (in addition to persona pronouns)
- add rainbows
License
AGPL-3.0
Contribution
- Discord:
@Wolfsblvt - Issues and pull requests are welcome.
- Any features/fixes should be pushed to the
devbranch.