Docs

Appearance

CharacterVault 1.3.0 ​

This release adds a standalone Lorebook Vault so books no longer have to live on a single character, a fuller SillyTavern World Info editor, and a fullscreen recursion map with a visual web of unlock paths and safe bulk flag edits.

Try it: https://vault.charactervault.appDocs: https://vault.charactervault.app/docs/

Highlights ​

Lorebook Vault ​

A second home vault, alongside Characters, for standalone lorebooks.

  • Create, search, import, export, duplicate, and delete books independent of any character
  • Importing a book names it from the filename, including Windows copy suffixes like (1), rather than the shorter name stored inside the JSON
  • SillyTavern book scan settings (scan_depth, token_budget, recursive_scanning) survive import and are written back on export
  • Full workspace for each book: the shared entry editor, Orion chat, and history/snapshots
  • Local IndexedDB only, same privacy model as character cards

Lorebook Vault →

Linking and sync ​

A character can link one library book, and multiple characters can share the same book.

  • Linking a book to a character offers to copy that book onto the card, replacing whatever lorebook was already there
  • While linked, edits made in the Lorebooks vault update every character that shares the book
  • "Open in vault" writes the character's current lorebook back to the library book, then opens it there
  • Detach a character at any time to stop it following the library book
  • Exporting a card includes the lorebook as it currently exists on that character, not a reference to the linked book

Linking →

Lorebook editor (shared) ​

The character tab and vault books now share a single editor.

  • Content first: title, keys, Enabled / Constant, and the content editor stay on screen at all times
  • Options and Attach are header buttons that open a panel over the editor; Done or Escape closes it
  • On a phone, the entry list and the editor swap places, and Attach sits next to book settings on the list
  • Supports the common SillyTavern fields: selective logic, recursion flags, probability, depth/role, match whole words, and book scan depth / token budget / recursive scanning
  • AI context usage bar and per-entry eye toggles, available with Character Vault AI
  • Books now come in through the Lorebooks vault and get attached from there. The editor no longer replaces the current book from a JSON file directly. Export is unchanged
  • Field help icons match the terms used in SillyTavern World Info

Lorebook Editor →

Recursion map ​

A visual way to see which entries can trigger which, instead of guessing from a flat list.

  • Web view lays out the whole book as a node graph, with arrows showing unlock paths, clustered by chain
  • Pan, zoom, and hover to spotlight a node's paths. Click to inspect and pin those paths, hover another node to temporarily override, and click again or use the inspector's X to clear. Ctrl-click to select multiple
  • Edit primary keys directly on the map. Changes write to the real entry and the arrows rebuild immediately
  • List view adds search and All / Linked / Standalone filters, and is used automatically as a fallback on large books
  • Per-entry flag toggles live right in the inspector and apply immediately
  • Bulk edits are staged first: pick a flag change, review exactly what will change and for how many entries, then apply or discard. Nothing changes silently
  • The camera holds its position when you inspect a node or when arrows change, and dense books wrap into tall ranks so pan and zoom stay smooth without redrawing every edge
  • This is an authoring aid based on primary keys found in content, not a full SillyTavern runtime simulation. The map only shows a recursion warning when a book has explicitly turned recursive scanning off

Recursion map → · Guide →

Snapshots ​

Standalone books get their own History modal. The "Opened" snapshot is the baseline: you can update it in place, but you cannot delete it. Save a snapshot when something actually changes, and restoring a book also updates every character linked to it.

Snapshots →

Upgrade ​

Client only app. Open the hosted site or rebuild locally.

bash
git clone https://github.com/spaceman2408/CharacterVault
cd CharacterVault
npm install
npm run dev

Existing character data and settings continue to work as is. IndexedDB gains lorebook tables the first time you open a build that includes this feature, through a schema migration. Export lorebook JSON if you want portable copies outside the browser.

Hard refresh if the UI looks stale after deploy.

Docs ​

Privacy

Copyright © 2026 spaceman2408