Docs

Appearance

Changelog ​

1.8.4 (2026-10-08) ​

CharacterVault 1.8.4 lets you pin and rank OpenRouter hosts, keep prompts private or stick to free models with new OpenRouter Options, keep Exacto on for Agent tool calls, and merge a library lorebook into a character's own entries, plus a fix for typing spaces in book names. Full notes: v1.8.4 release notes.

Highlights ​

  • OpenRouter host control — pin a host per model under Provider (with Only use this host), set Settings → AI Config → OpenRouter Options → Host priority (Balanced, Cheapest, Fastest, Quickest start), and see which host answered in a reply's stats
  • OpenRouter privacy and model filters — OpenRouter Options → No training on prompts / Zero data retention only / Free models only, all off by default; with a key, model lists show only models that key can use
  • Exacto for the Agent — OpenRouter Options → Always use Exacto for the Agent keeps :exacto on Agent tool calls even with a host priority set
  • Merge a library book — Character → Lorebook → Attach offers Merge next to Replace when the character has entries: the book's entries go after them and the book is unlinked
  • Fix: book names with spaces type normally in the Lorebooks workspace

Details: AI Setup · Lorebook Vault · What's New

1.8.3 (2026-10-01) ​

CharacterVault 1.8.3 adds clickable variable chips to every prompt template, keeps linked lorebooks in sync both ways, and makes Settings ask before throwing away unsaved changes, plus Paste from Clipboard on import and a round of Settings and lorebook fixes. Full notes: v1.8.3 release notes.

Highlights ​

  • Prompt variable chips — Settings → Prompts and Settings → Creation Studio → Generation Prompts list each prompt's variables as named chips: click to insert at the cursor or find one already used, green when used, red when a required one is missing
  • Two-way lorebook sync — saved lorebook edits on a linked character (character → Lorebook → Attach) update the library book and every other linked character; Open in vault takes an Auto snapshot first
  • Settings that keep your changes — closing with unsaved edits asks Keep editing or Discard, saving waits for settings to load with Try again on failure, and backups restore the stored key and font size
  • Paste from Clipboard on the import page, NanoGPT and Synthetic referral sign-up links next to API Key, Ko-fi links
  • Fixes to confirm dialogs, prompt model routing, NanoGPT sign-in, custom button labels, the context length field, and attached lorebooks

Details: AI Creation Studio · Lorebook Vault · What's New

1.8.2 (2026-09-30) ​

CharacterVault 1.8.2 makes inline AI results easy to retry, time, and reuse, speeds up search, font size, image links, and name macros in the editor, and carries card lorebook options and JPEG or WebP images cleanly to SillyTavern, plus a bigger spellcheck dictionary and a round of editor fixes. Full notes: v1.8.2 release notes.

Highlights ​

  • Inline AI results — ↻ Retry on the result and error strips, Reject reopens Custom with your instruction, model / TTFT / speed pills, a ⚠ Cut off at Max Tokens warning, Rewrite / Insert on Custom, and ↑ or the clock button for your last 10 instructions
  • Faster editing — Ctrl+H replace, F3 / Ctrl+G to step matches, a live aA font slider with Ctrl/⌘ + = / - / 0, Ctrl+click to open image links, and Backspace to keep a plain char / user (Settings → Character Workspace → Name macros)
  • Clean round-trips to SillyTavern — card lorebook options (recursion, probability, depth, order, position) import and export where SillyTavern reads them, older cards catch up when opened, and Export → PNG converts JPEG or WebP images
  • Bigger spellcheck dictionary, Creation Studio asks before discarding an unsaved card, IME-safe Enter / Esc, refreshed docs
  • Fixes to editor highlighting, macro conversion on Enter and paste, empty AI replies, search, and snapshot diffs for AI context pins

Details: Text Editor · Import & Export · What's New

1.8.1 (2026-09-29) ​

CharacterVault 1.8.1 brings snapshot diffs laid out like the Agent review, a one-click Orion / Agent switch with edit-and-resend in Orion, and a Creator Notes preview that can't quietly phone home, plus a large round of fixes to saving, import, export, and the lorebook editor. Full notes: v1.8.1 release notes.

Highlights ​

  • Snapshot diffs — Snapshots → pick a revision: one card per change, side by side on wide screens, word highlights, Restore per card, one card per greeting and lorebook entry, and no more empty diffs
  • One chat header — the chat bubble (Orion) and robot (Agent) at the left of the chat header switch modes; the pencil on your last Orion message edits and resends, and × cancels
  • Remote content — the Creator Notes preview loads only https images, fonts, and styles and warns when they come from another site (Settings → Character Workspace → Warn about remote content in Creator Notes preview, on by default); images in chat replies are links
  • Card tokens in the header, greeting and lorebook entry tokens, drop or paste a card image, Retry in Orion, reset one prompt to default, Agent key test
  • Fixes to saving, greetings undo, lorebook number fields and SillyTavern export UIDs, and PNG import of ccv3 and compressed chunks

Details: Snapshots & History · AI Assistant · Creator Notes · What's New

1.8.0 (2026-09-27) ​

CharacterVault 1.8.0 makes the AI Agent easier to steer, follow, and review: edit and resend your last message, @-mention fields and entries, see what each run is doing and what earlier runs changed, and check its edits in a clearer diff. Full notes: v1.8.0 release notes.

Highlights ​

  • Steer the Agent — pencil on your last message to edit and resend (nothing removed until you send), type @ to mention a field, greeting, or entry, card-aware starter suggestions on an empty chat, and Continue after the 32-turn limit
  • Know what it is doing — the status line names the target (Updating Description), each request carries notes on what earlier runs changed and your review choices, and the tab title reads Agent finished when a run ends while you are away
  • Clearer review diffs — with Settings → Character Workspace → Review agent edits before applying on: side by side on wide screens, inline on phones, word highlights, and Show N unchanged lines folds
  • Editor edits made during a run are kept; transient provider errors retry with backoff; long runs trim old tool results to fit Context Length

Details: AI Agent · What's New

1.7.5 (2026-09-24) ​

Clearer agent-review greeting diffs and custom tags in Creation Studio gender rules. Full notes: v1.7.5 release notes.

Highlights ​

  • Agent review — new/removed greetings are labeled (empty Original side for a new one), and Greetings-list rewrites show per-greeting blocks with counts and New / Removed badges; text diffs align by paragraph and line
  • Studio custom tags — Feeling Lucky draws merged built-in + custom pools, and custom tags gray out by gender opposition like built-ins
  • Agent rejects empty greeting adds/updates with an error

Details: AI Agent · AI Creation Studio · What's New

1.7.0 (2026-09-22) ​

Customizable AI toolbar, roleplay highlight colors, and editor quality-of-life. Full notes: v1.7.0 release notes.

Highlights ​

  • Customizable toolbar — reorder, hide, and re-add built-in buttons in Settings → Prompts → Toolbar Buttons; extras collapse into More; bulk remove with one confirm; delete/reset ask first
  • Custom buttons — create your own with label, icon, color, ${text} prompt template, and per-button model
  • Roleplay colors — "dialogue", narration, and *actions* highlighted on by default; recolor under Character Workspace → Roleplay colors; / recolorable under Name macro colors
  • Editor: line highlight only with no selection, search prefilled + Ctrl+H replace, font-size slider/shortcuts, Char/USER macro expansion, split-preview undo retention, placeholders, no touch keyboard pop

Details: Text Editor · What's New

1.6.0 (2026-09-10) ​

Full vault backup and restore, Settings backup, and editor quality-of-life. Full notes: v1.6.0 release notes.

Highlights ​

  • Vault Backup ZIP includes cards, standalone lorebooks, and settings; Import a ZIP to restore (cards/books as copies; settings replace on this device)
  • Settings → Backup exports/imports config as JSON; keys optional; import is a draft until Save
  • Editor: header save status, live chars/words/tokens, editable Extensions JSON, Ctrl+S / ⌘+S to flush pending saves
  • Greetings duplicate + reorder; lorebook entry duplicate (next available ID); in-app confirms and toasts

Details: Import & Export · Text Editor · What's New

1.5.0 (2026-09-05) ​

AI Creation Studio overhaul and optional Agent review diff. Full notes: v1.5.0 release notes.

Highlights ​

  • Studio: custom field prompts, First Message / Examples toggles, Dynamic and Kink & Fetish tags, favorites / recents / custom tags, sticky Go Back
  • Agent: optional review modal with word-level Original / Agent diff; approve, edit, or deny before writes land
  • Settings split into Creation Studio and Character Workspace; vault header Settings and top pagination

Details: AI Creation Studio · AI Agent · What's New

1.4.5 (2026-08-28) ​

Orion and Agent chats persist per character and lorebook. Full notes: v1.4.5 release notes.

Highlights ​

  • Ask Orion and the Agent keep a thread per character and per standalone lorebook
  • New chat confirms, then clears only that panel; leaving keeps the saved transcript
  • Load earlier pages older turns; on-screen window stays small, disk cap is 500 per thread
  • Closing Ask AI unmounts character chat so a switch cannot leak the previous thread

Details: AI Assistant · AI Agent · What's New

1.4.2 (2026-08-27) ​

Agent write recap and jump-to-target, plus Settings and stream cleanup. Full notes: v1.4.2 release notes.

Highlights ​

  • Click a successful Agent write line to open that field, greeting, or lorebook entry
  • Write turns keep speech (or show Applied N writes); Native / XML chip and English busy labels
  • NanoGPT sign-in cancels when the popup or Settings closes; model catalogs are not persisted
  • Settings aborts catalog and account fetches on close; Orion/Agent live streams and chat timers cannot outlive the panel

Details: AI Agent · What's New

1.4.1 (2026-08-25) ​

Agent chat polish, a rewritten first-run tutorial, and a staging preview banner. Full notes: v1.4.1 release notes.

Highlights ​

  • Agent composer stays focused during a run; Agent writing lives in the workspace header
  • Live Agent speech streams after thinking (XML stripped, buffer capped)
  • Retry and regenerate clear per-message error bubbles
  • Native tools vs XML: a tools 400 is cached per model, the turn retries XML-only, later runs skip native tools
  • First-run tutorial covers vault libraries, AI Create, Orion vs Agent, lorebooks, and snapshots
  • Production vault header can point people at staging.charactervault.app

Details: AI Agent · What's New

1.4.0 (2026-08-22) ​

The Agent: a chat that reads and edits the open character or lorebook through tools. Full notes: v1.4.0 release notes.

Highlights ​

  • Agent in the character workspace and standalone lorebook vault: list, read, add, snippet-edit, update, and delete through tools
  • One character-agent session across workspace tabs; writes land when the run finishes (snapshot first)
  • Own model on Settings → Prompts → Agent; Settings → Studio → Chat panel can default Ask AI to Orion or Agent
  • Native function calling when the provider supports it (XML fallback otherwise); live prompt token count; TTFT / t/s on replies
  • History opens from a metadata index instead of loading every snapshot payload; opened-card snapshot stays last in the list
  • Leaner long sessions: chunked token streams, 100-message agent transcript cap, clipped thinking buffers
  • NanoGPT cache routing — Cache-capable provider routing toggle sends caching: true, routing to a cache-capable provider (sticky by default; fails if none serves the model)

Details: AI Agent · AI Setup → Prompts · Snapshots

1.3.1 (2026-08-20) ​

Synthetic and OpenRouter get dedicated adapters and live usage cards. Full notes: v1.3.1 release notes.

Highlights ​

  • Synthetic preset: syn: aliases first, embedding models filtered, Synthetic Usage card (five-hour requests + weekly credits)
  • OpenRouter adapter: display names, text-only catalog, reasoning efforts, OpenRouter Usage card (key spend, optional cap, free-tier :free limits)
  • API key field is masked without being type=password, so Save Settings is less likely to trigger a browser password save
  • Synthetic keeps top_k and repetition_penalty on the OpenAI-compat path

Details: AI Setup · Synthetic Usage · OpenRouter Usage

1.3.0 (2026-08-17) ​

Standalone lorebook vault, richer World Info editing, and recursion map. Full notes: v1.3.0 release notes.

Highlights ​

  • Home vault Lorebooks tab: CRUD, import/export, duplicate, open full workspace
  • Shared lorebook editor for character-embedded and vault books (common ST fields + CodeMirror/AI content)
  • Content-first layout: Options and Attach open from the entry header over the editor; list↔detail on mobile
  • Link one library book per character; Open in vault and vault edits keep linked cards in sync; optional copy onto the card
  • Recursion map rebuilt as a fullscreen web view (node graph, pan/zoom, hover spotlight) with staged bulk flag edits and per-entry flag toggles in the inspector
  • Lorebook snapshots (Opened baseline + manual; no auto)
  • Field help tips from SillyTavern World Info docs

Details: Lorebook Vault · Lorebook Editor · Recursion map · Map guide

1.2.1 (2026-08-07) ​

Editor polish: Markdown image links, name macro colors, and smarter spellcheck. Full notes: v1.2.1 release notes.

Highlights ​

  • Markdown ![](url) image syntax is highlighted; optional click-to-open with a leave-app warning
  • Toggle under Settings → Studio → Editor links (highlight stays on either way)
  • / name macros get distinct syntax colors
  • Spellcheck skips Markdown image constructs and accepts hyphenated compounds when segments are valid

Details: Editor → Markdown image links · Spellcheck

1.2.0 (2026-08-03) ​

Custom context, lorebook context controls, and modern sampler defaults. Full notes: v1.2.0 release notes.

Highlights ​

  • Per-character Custom context in the AI Context panel (paste/edit, enable toggle, remove)
  • Included in Orion and the AI toolbar (and lorebook key generation) when enabled
  • Vault-local only — not on the card, not in PNG/JSON export or snapshots; copied on duplicate
  • Lorebook Enable All / Disable All for context moved out of book settings into the entry list toolbar
  • New-install defaults: streaming + reasoning on, neutral samplers, 8K context
  • Quick presets Creative / Balanced / Factual updated (min-p first, top-k off); presets keep your context length
  • Vault cards without art show a single No image label

Details: AI Context → Custom Context · Sampler Settings

1.1.0 (2026-07-21) ​

Orion chat improvements and small polish. Full notes: v1.1.0 release notes.

Highlights ​

  • Smoother Orion streaming; stop mid-reply keeps partial answers
  • Resizable desktop Orion panel; scroll that follows the stream until you scroll up
  • Delete a message and trim the rest of the thread
  • Snapshot history easier on phones; theme-aware tags and Feeling Lucky vortex
  • Privacy notice linked from the app and docs

1.0.0 (2026-07-17) ​

First stable release. Full notes: v1.0.0 release notes.

Highlights in this release ​

  • Full UI refresh (vault, editor, settings, studio) and VS Code Dark+ style dark theme
  • AI Context and Orion panels streamlined; context is user-pinned (not auto-bound to the open tab)
  • Editor AI ghost preview, payload preview, and per-tool model routing
  • NanoGPT sign-in, account overview, expanded reasoning effort, context up to 1M
  • Vault backup, bulk import, sort/search, card token estimates
  • Mobile full-screen greetings/lorebook and sheet-style model pickers
  • Spellcheck, section layout customization, AI Creation Studio, snapshots

Current Release Notes (detail) ​

  • Per-prompt model routing — Settings → Prompts can map each toolbar operation to a specific base URL + model (any configured preset). Unmapped ops use global AI Config. Lorebook AI key generation follows the Custom/instruct mapping. Orion and AI Creation Studio remain on the global model. Clear AI Settings keeps prompt text and mappings.
  • Mobile model/provider sheets — AI Config and Prompts model pickers use portaled bottom sheets (searchable, Escape-safe, touch-friendly) instead of clipped dropdowns.
  • AI toolbar ghost preview — Enhance / Rephrase / Custom / polish ops preview in the editor as inline ghost text at the selection instead of a large top result panel. Thinking stays collapsible and collapsed by default; Accept / Reject and stats stay in a compact strip. While a suggestion is open the editor is read-only for typing, IndexedDB saves are held until Accept/Reject/cancel, Accept shows a success toast (green highlight flash removed), and leading/trailing newlines are matched to the original selection to avoid blank-line glitches.
  • NanoGPT Account card — Balance (USD/Nano), subscription status, and quota bars when available; session cache + rate-limited refresh; skeleton layout avoids settings jump while loading.
  • Reasoning effort — Expanded levels (minimal … max / xhigh); docs guide under Configuration; request repair remaps unsupported effort values and strips rejected non-standard sampler params with per-model session cache.
  • Context length up to 1M — Sampler settings include 256K / 512K / 1M presets and a Custom… range (4,096–1,000,000 tokens). Values are clamped on save.
  • Large AI context packing — Lorebook and alternate greetings are sent as separate chunks and fill the available window instead of being dropped when the whole block is too large. Token estimates and request trimming are stricter so big prompts are less likely to exceed the provider limit.
  • Vault backup — Library Backup downloads a ZIP of all characters (PNG with image, JSON without).
  • Bulk import — Multi-file import and drag-and-drop of PNG/JSON onto the library.
  • Library sort & search — Sort by name or recent; search matches name and tags.
  • Card token estimates — Active / total token estimates on each vault card (hover for exact counts).
  • Quick library export — Export a single card as PNG or JSON from card actions without opening the editor.
  • API key field — More stable field naming so browser password managers are less likely to hijack the AI key input.
  • In-editor spellcheck — A Hunspell-backed spellchecker (English dictionary) runs inside the shared editor. Misspelled words are underlined with a wavy-red decoration; hover one to see a quick-fix tooltip with suggestions plus Ignore word and Add to dictionary. Code fences, placeholders, numbers, and ALL-CAPS acronyms are skipped automatically. Creator Notes (HTML) and Extensions (JSON) are language-aware: HTML tag structure and JSON property keys are skipped so technical content doesn't pollute the underline. Your ignored words and personal dictionary persist across all cards. Toggle the feature in Settings → Studio → Spellcheck. The dictionary is cached in IndexedDB after first load, so it works offline.
  • NanoGPT PKCE sign-in — Sign in to NanoGPT directly from Settings → AI Config with a new Sign in with NanoGPT button. The OAuth flow uses PKCE (no client secret, no password leaves NanoGPT), and your available models are automatically fetched and loaded into the model picker as soon as sign-in completes. Popup blockers must be allowed. Works on Chrome for Android; other mobile browsers may not relay the auth code back — paste an API key manually if sign-in doesn't complete on your phone.
  • Added a Sections tab in Settings — hide, reorder, and reset your section tabs to match your workflow.
  • Improved the AI Settings tabs so they are easier to read and no longer overlap.
  • Reduced unwanted browser password prompts when entering AI settings.
  • Improved the character history view for screen readers.
  • Added simple editing for character names and creator names.
  • Added a cleaner tag editor where you can add, paste, and remove tags quickly.
  • Improved tag choices in AI Creation Studio so related tags work together more reliably.

Latest Commits (Newest to Oldest) ​

  • 6b077a7 - feat(settings): Prompts tab per-operation model routing UI
  • f8574b2 - feat(settings): mobile-friendly model and provider picker sheets
  • fae7f3e - feat(ai): apply prompt model map to toolbar and lorebook requests
  • 0268062 - feat(settings): persist and load per-prompt model routing map
  • f2e405d - feat(ai): add per-prompt model binding types and config resolver
  • 81ebf71 - Merge branch 'feat/ai-request-param-repair'
  • 62c142a - feat(ai): remaps rejected request params and expands reasoning effort
  • 7aedd8d - docs: document AI toolbar ghost preview in editor, FAQ, and release notes
  • ef2709c - feat(editor): in-editor AI ghost preview for toolbar edits
  • cd8b170 - feat(settings): show NanoGPT balance and subscription usage at a glance
  • c0f175c - refactor(settings): persist NanoGPT account cache across unmount
  • 879cf12 - fix(settings): use current subscription-only flag when fetching models
  • 58bd001 - feat(editor): improve AI accept feedback, shortcuts, and selection lock
  • 944142b - fix(editor): abort in-flight AI on unmount and ignore stale results
  • 65a9c8d - feat(ai): raise context to 1M and fix large-lorebook budgeting
  • 663a513 - feat(vault): backup, bulk import, sort/search, and token estimates
  • 969dfbf - update ignore
  • 995c932 - refactor(settings): use useId for AI API key field name
  • 3238cf4 - refactor(settings): split panel into modular tabs and registry
  • 00c188d - feat(auth): auto-fetch models after NanoGPT OAuth sign-in
  • f019115 - style(ui): update NanoGPT sign-in success toast message
  • 55c0ec7 - feat(auth): add NanoGPT OAuth sign-in flow
  • 974ff11 - refactor(ai): enhance copy button timeout handling and variable scoping
  • 461ace4 - feat(mobile): enable copy button visibility on mobile devices
  • 43bb8ce - feat(ui): add stats tooltip and mobile copy button visibility
  • 4379702 - feat(ai): implement response performance metrics
  • 2789636 - feat(character): adjust sampler parameter ranges
  • 8952b08 - perf(character): optimize model caching and provider selection
  • 456ded4 - feat(eslint): add 'docs' to global ignores in ESLint configuration
  • a33ff1d - feat(character): add caching for AI models in settings panel
  • 52de543 - feat(character): implement imported character flag for conditional snapshot creation
  • cce7d44 - feat(ui): add create new button and improve create form layout for mobile
  • 281be66 - fix(editor): integrate toolbar search with CodeMirror panel lifecycle to stop selection scroll oscillation
  • 324ce81 - feat(editor): enhance search navigation with auto-scroll and panel positioning
  • 9a014e0 - fix(ai): resolve context at call time to prevent stale system prompt
  • 1992244 - feat(editor): add custom tab handling and indentation settings in useAIEditor
  • 9722bba - feat(editor): add lorebook import and export functionality
  • 640e573 - refactor(lorebook): filter out empty character books during export
  • 9d0d662 - refactor(history): prevent content flash during modal entrance with delayed visibility
  • d4f9696 - feat(components): enhance input handling and loading animations
  • 9fc0bd7 - refactor(db): implement content-addressed storage for character images
  • aa4cc58 - feat(ai): enable multi-line input in AI chat and toolbar panels
  • 24a629d - refactor(lorebook): swap name and comment fields in entry editor to match SillyTavern convention
  • f4618c6 - refactor(lorebook): extract case_sensitive extension handling to variable
  • 7851a6f - fix(lorebook): Lorebook Export/Import Compatibility Fix

Privacy

Copyright © 2026 spaceman2408