Tzurot Slash Command Reference

Complete reference for every / command Tzurot exposes in Discord. For a high-level overview of what the bot does, see the project README.

Convention: subcommand groups (like /voice tts) are listed with their subcommands inline. Required argument prompts appear in the slash command UI; this reference focuses on what each command is for.


Characters & Personas

Command Subcommands Purpose
/chat (top-level) Chat one-on-one with a character
/random (top-level) Chat with a random character (optionally within a tag) — or have them read the room
/chime-in (top-level) Summon a character — or a random sample of a tag’s characters — to react to the recent conversation
/character create edit view browse Manage AI characters
import export template Character portability (JSON)
avatar (set clear) voice (set clear) Per-character avatar image and voice cloning enrollment
settings overrides Per-character config and personal overrides
alias browse alias add @mention aliases — personal (just you) or global tiers; Select several in browse removes a batch at once
/persona view edit create browse default User persona management
override set override clear Per-character persona overrides

Voice Configuration

TTS + STT provider selection and cloned-voice library lifecycle. Per-character TTS overrides cascade over user defaults; STT is user-scoped (your voice doesn’t change per character).

Command Subcommands Purpose
/voice view <character> Resolved TTS + STT for a character (with cascade source)
tts browse set clear default Per-character + user-default TTS provider config; Select several in browse clears a batch of overrides at once
stt set clear Transcription provider preference (user-scoped)
voices browse delete purge Cloned-voice library lifecycle

Presets & Channels

Command Subcommands Purpose
/preset create edit browse Custom LLM presets (model + parameters)
default (set clear) Your default preset — used for every character without an override; slot: Both targets text + vision in one command
override (browse set clear) Per-character preset overrides; Select several in browse clears a batch at once
export import template Preset portability (JSON)
global (default free-default) System-wide defaults (owner only); slot: Both targets text + vision
/models browse view Browse and inspect available AI models (by capability)
/channel activate deactivate browse settings Channel auto-response management

Memory & History

Command Subcommands Purpose
/memory browse search stats Browse and search long-term memories; a memory’s detail view shows 🧠 Reasoning when the character’s reasoning for that reply was kept; Select several locks or deletes a batch at once
facts (tag, query) Browse/correct facts a character learned about you; tag: narrows to one entity tag (e.g. commitment:promise), query filters by text; Select several locks or forgets a batch at once
delete purge Memory management operations
fresh (enable disable status) Fresh-start mode — replies stop using memories of you (they are kept)
incognito (enable disable status forget) Privacy mode (no LTM writes)
/history clear stats undo purge (scope) Conversation history management

/history purge scope: deletes only your own conversation history with the character in that channel by default; scope: Everyone's deletes every user’s, and needs the Manage Messages permission in that channel (or bot owner). Long-term memories derived from the deleted turns are retired too, with pinned memories kept.

Settings & Tools

Command Subcommands Purpose
/settings timezone (set view) Timezone for timestamps
apikey (set browse remove test) BYOK API key management
defaults (edit) User default settings dashboard
data (export delete) Data rights: export everything your account owns (ZIP, 24h link) or permanently erase the account (typed confirmation)
/feedback message Send feedback to the developer — the bot’s official contact channel alongside GitHub issues
/notifications view enable disable level cleanup Release-notes DM preferences — sent only to accounts that have actually used the bot, default level major (breaking releases only); levels come from release content (breaking→major, features→minor, fixes-only→patch); each new release DM replaces the previous one, and cleanup deletes them all on demand
/shapes auth logout browse import export status Shapes.inc character migration (legacy import); export downloads as a ZIP of per-section JSON and Markdown files
/inspect [identifier] Diagnostic log browser (LLM request flight recorder) — omit to browse recent, provide to inspect specific. Also openable by right-clicking either message of an exchange — the prompt or the reply — → Apps → Inspect Message, and Apps → View Reasoning jumps straight to that exchange’s reasoning trace. Views include input, assembled messages, generation params, memory, token budget, cache (cached tokens + hit rate), estimated cost (OpenRouter list price for the tokens used), reasoning, and before/after post-processing
/help commands [command] getting-started Command browser (index or per-command detail) and the in-Discord onboarding screen

Settings dashboards: Reset page / Reset all: on /settings defaults edit, /character settings, /character overrides, /channel settings, and /admin settings, every page whose settings all have an Auto state carries a ♻️ Reset page button (disabled when nothing on the page is set at that level) that, after a confirm naming how many settings go back to Auto, clears them in one save. The Index hub of the first four dashboards also carries ♻️ Reset all for every setting the dashboard shows. /admin settings has Reset page on its Memory, Context & Display and Voice pages (cleared values fall back to the built-in defaults) and no Reset all; its System pages have no reset yet. Channel settings’ old “Reset to defaults” button is replaced by these.

Administration (owner only)

Command Subcommands Purpose
/admin ping health metrics servers kick usage Monitoring and management
cleanup db-sync broadcast settings presence Maintenance and configuration
/deny add/remove × everywhere server this-server User and guild denial management
channel character · browse view (scope is the subcommand name); Select several in browse removes a batch at once

db-sync deletion semantics: hard deletes on synced tables PROPAGATE — deleting a row (preset, character, persona…) in either environment deletes it in the other on the next sync, instead of the old resurrect-from-the-other-side behavior. Corollary for one-off cleanup scripts: an accidental DELETE on one side now applies to both on the next sync (clear the matching sync_tombstones row to undo before syncing). Re-creating a row after deleting it wins over its tombstone. Syncs also run automatically once a night, scheduled from the PROD bot at an owner-configurable UTC hour (default 07:00 UTC ≈ 3am US Eastern) and silent when nothing changed — so “the next sync” is at most ~24h away even without a manual /admin db-sync. Both the hour and the on/off switch live in /admin settings → System · Operations.