Repository navigation
Cardwright v1.2.0
Cardwright 1.2.0 adds reusable player personas, configurable role placeholders, and editable avatar prompts while preserving the existing character-card workflow.
New features
- Generate an avatar prompt from the current card using the selected AI provider, edit it, and copy it into your image generator.
- Save reusable User Persona presets with Name and Description, plus validated JSON backup/import. Persona context is used only for card generation; the default is None.
- Choose
{{char}} / {{user}},{char} / {user}, or{character} / {user}in the sidebar. Prompts and audits share the same role definitions. Existing card text is not automatically converted. - Persona selection, placeholder preference, and avatar prompts are saved locally with the current card and stay outside character-card exports.
Fixes
- Preserve concept-generated text when navigating, auditing, saving, or exporting.
- Keep legacy lorebook entries and metadata when editing or adding entries.
- Preserve alternate greetings, including empty messages, whitespace, line endings, and embedded separators during import/export.
- Bind field drafts, audit fixes, and lorebook AI edits to their original card and target. Navigation, deletion, and late responses cannot redirect those edits to another target; newer manual edits are protected.
- Preserve explicit local model choices. Late model detection and connection-test results cannot overwrite newer settings.
Local server and API-key changes
- Switching provider or changing the base URL clears the previous API key. Enter the key for the new endpoint if required.
OPENAI_API_KEYis used only for the server's configured endpoint. For OpenAI, setOPENAI_PROVIDER=openaiwith the key.- The server accepts local clients, validates Host and browser origin, and serves only public app assets. Hidden files and repository internals are not served.
- Provider URLs must use HTTP or HTTPS without embedded credentials, query strings, or fragments. Configure the final URL directly; provider redirects are rejected.
- Browser API requests require JSON. Keys entered in Settings remain in this browser's local storage until cleared or the provider/endpoint changes.
Validation
- All 124 regression tests pass, covering data preservation, JSON/PNG round-trips, persona backups, placeholder prompts and audit rules, model selection, and server access controls.
- New UI flows were checked in a real browser against a local mock provider. Server forwarding and access controls were also checked with real local HTTP requests.
- AI checks use mock responses; no live hosted-provider generation is required for the test suite.
Download and run
Download the source ZIP below and extract it. Start with start-windows.bat, ./start-macos.sh, or node server.mjs, then open http://127.0.0.1:8787.
See README and User Guide for setup and usage.