Lexis-AI has ten commands. Call them as described in Getting started (/event, /lexis-ai:event, $event … depending on your tool).
| Command | Use it | Writes |
|---|---|---|
/world-init |
once, to create a world (or to fill in what you deferred) | the world files |
/event |
right after something happens at the table | the session log |
/ripples |
when you want more consequences of an event | the session log |
/help-skills |
for a rules question | nothing |
/create-aspect |
for a scene tag (aspect, feature, circumstance …) | the session log |
/create-obstacle |
for a lock, trap, puzzle, hazard or social obstacle | the session log |
/create-scene |
when the players enter a place | the session log |
/create-lore |
for a new NPC, place, group or story hook | proposals/ + the session log |
/close-session |
at the end of the session | the world files (only what you approve) |
/lexis-help |
when you forget a command or what to do next | nothing |
prep or detailed (in any language: hazırlık, vorbereitung …) to a command for more depth between sessions: /ripples E2 prep./world-init answers, approvals at /close-session.Creates a world in the current folder, in three tiers so you are never forced to decide everything up front.
It writes world.md, system.md, a short AGENTS.md, the folders characters/ locations/ groups/ hooks/ sessions/ proposals/ and one file per accepted entity. It does not open a session log; /event does that.
Fill mode (complete an existing world): run /world-init in a folder that already has world.md. It never overwrites; it scans the world and shows one numbered list of what is missing, with a suggested action for each:
system.md (it asks your system’s setup questions), or a system: that names a system that is not installed;world.md sections;## Uncertain lines from /world-init);## Links;next link in the chain) that are not yet an arc (World files).Missing folders and the world’s AGENTS.md are created without asking. You answer the list once (all, 1, 3: Gabriel, Ayşe (PC); rest later, 3 you suggest), and it fills in only what you chose. Characters can be marked PC or NPC.
Switching the game system: say so in fill mode (“switch to 5E”). It sets system: in world.md, asks the new system’s setup questions, rewrites system.md (keeping your homebrew, flagged for a check) and offers to redraw the system sections of every character, location and group file from their fiction. Only installed systems can be chosen; run lexis-setup again to add one.
/event <what happened, in one or two sentences>
E<n> in the open session log (it opens sessions/session-NNN.md if none is open).⚠ rule conflict (IR<n>) with three options: (a) it only looks like a violation, (b) a costly exception, (c) the rule changes. You can answer now or at /close-session.🧭 when the event completes the current step (decided at /close-session), jumps ahead to a later step, or removes something a later step needs. A jump or a threat becomes a decision: (a) offstage / plan holds (b) reorder / the step changes (c) drop the steps. The event is never blocked.R<k>), each tied to the file it would change.## Links; never written to a file).L<j>) if the event obviously creates a relation.📌 E2 recorded (session-001) · Lens: power-politics
Ripples (hypothesis):
- R4 The mayor orders the cemetery closed "for repairs"
- R5 🔒 The troupe's patron pays the mayor a visit
Who might know:
- [[mayor-harkin]] — may hear (owner → [[old-cemetery]])
⚠ D1: IR2 conflict — (a) apparent (b) costly (c) rule changes? Now or at session end.
/ripples [E2 | S003-E2 | a description] [prep]
Takes an event that is already recorded and looks at it through lenses: power and politics, society and rumor, faith and the supernatural. It adds new ripples (never repeating old ones) and traces how word could spread 2-3 steps, marking how the news weakens (as a rumor, distorted). Default event: the last one. In prep mode it uses every fitting lens and explains each ripple.
/help-skills <what the player wants to do>
A rules answer in your system’s terms. It records nothing.
Examples per system: Game systems.
/create-aspect [scene or situation]
One scene tag for the current scene, in your system’s form: a Fate aspect with an invoke and a compel; a 5E scene feature with its rule effect; a circumstance, situational modifier, DR shift, position/effect factor or clock in other systems. Every tag is two-sided: one way it helps the PCs, one way it hinders them. Logged as G<n>; a lasting one (a place’s feature) can become canon at /close-session.
/create-obstacle [what you need]
One obstacle, fiction first:
then your system’s block: the suggested difficulty, fitting checks, what success and failure levels mean, trap or hazard numbers, and 2-3 “success at a cost” options. Logged as G<n>.
/create-scene <place> [your notes]
/create-scene old-cemetery night, thick fog, the gravekeeper is gone, one grave dug open
The players walk into a place: you give the place and a few notes, it fills the gaps. Your notes are kept exactly; everything it adds fits the place’s file, the session’s events, your Immutable Rules and the hidden truths.
Wisdom (Perception) DC 15, Careful, Fair (+2), Survey, risky/standard …), or no roll.🧭 line if an interaction can open an active arc’s step.🎬 G3 · Old Cemetery — The Open Grave
Fog swallows the lantern light ten steps out. Somewhere a shovel scrapes …
Here:
- [[keeper-dog]] — growling at the open grave · Hostile
Interactions:
1. The open grave → fresh boot prints lead to the chapel · Wisdom (Survival) DC 12
2. The gravekeeper's hut, door ajar → his ledger · no roll
3. The dog → it won't let anyone near the grave · Wisdom (Animal Handling) DC 15
✨ Thick fog — helps: hiding (Advantage on Stealth) · hinders: sight beyond 3 m
🔒 GM: the grave was emptied from below. If they linger, the shovel sound comes closer.
Logged as G<n>. Nothing is written to the place’s file; at /close-session you can keep lasting details (a new feature, a new person) for the place. Prep mode adds sub-areas, more interactions and each NPC’s hidden motive. A place with no file works too; it offers /create-lore to make it lasting.
/create-lore <what you need: an NPC, a place, a group, a hook>
One persistent entity (an NPC, place, group, hook or arc: /create-lore an arc from <hooks>), written to proposals/<slug>.md from the world’s template, with the system sections your game needs (aspects in Fate, a stat line in 5E …) and 1-4 links to existing files. A new hook always gets its own hidden truth, consistent with the others. It becomes canon only if you approve it at /close-session.
/close-session
Builds one numbered list of everything from the session and waits for one answer. Nothing is written before you answer.
| Group | What you decide |
|---|---|
| A. Open decisions | rule conflicts, broken hidden truths, arc skips and threats: (a)/(b)/(c) |
| B. Events | the concrete changes the events make to world files (already canon; suggested ✅) |
| C. Arcs | a step done → its hook resolved, the next hook active; the last step → the arc resolved; reordered or changed steps |
| D. Ripples | ✅ it happened · ❓ uncertain (goes to ## Uncertain) · ❌ drop |
| E. Link proposals | ✅ / ❌ |
| F. Generated items | was it used? lasting scene tags can join a place; lore can become canon (✅), stay a proposal (⏸) or be deleted (❌) |
| G. Old uncertain items | promote, remove or keep what this session confirmed or refuted |
| H. Info | dangling links, unknown names |
Answer in plain words: all as suggested, 3 ✅, 5 ❌, rest as suggested, 1 c: <new rule text>, defer 4-6. Deferred items keep the log pending and come back next time.
✅ Session 001 closed (closed)
- Updated files: [[old-cemetery]], [[gravekeeper]]
- Added to uncertain: 3 · Rejected: 2 · Proposals kept: 1
- Rule change: —
- Arcs: [[the-yellow-curtain]] step 2/4 → [[the-masters-letter]]
/lexis-help [a command | a question]
A short guide that writes nothing.
/event, /lexis-ai:event, $event …). In a world it adds the world’s name, system and language, the open session (E3 R7 G1 D0) and one suggested next step: /world-init if the world is missing something, /close-session if a log is pending, and so on./lexis-help event): that command’s usage, what it writes and an example./lexis-help how do I add a PC?): the command that does it, with an example.📖 Lexis-AI
- /world-init — creates a world, or completes an existing one
- /event — records what happened, ripples, who might know
…
🌍 Vespera · 5E SRD · Türkçe
- Session: session-002 open, E3 R7 G1 D0
- 🧭 The Yellow Curtain: step 2/4 [[the-yellow-curtain]]
- Next: keep reporting with /event; /close-session at the end