De Lore Is
De Lore Is is a local continuity checker for fictional worlds. It keeps track of the people, places, events, and rules you give it, checks them for contradictions, and can explain which decisions support an answer.
It’s for writers, worldbuilders, and people building tools that work with
fiction. You can write lore in .dli files and check it from the command line,
or connect an MCP client, such as an AI assistant, to work with a local world.
The checks don’t call a model.
You decide what to record and which rules apply. De Lore Is checks structured lore; it doesn’t read a manuscript and find plot holes on its own.
Try it
Install from crates.io with Rust 1.96 or later:
cargo install deloreis --locked
Save the following as story.dli:
scope story
ratify d-0001
person arthur "Arthur" decided d-0001
place camelot "Camelot" decided d-0001
place avalon "Avalon" decided d-0001
functional home decided d-0001
fact arthur home camelot decided d-0001
fact arthur home avalon decided d-0001
Here d-0001 names the decision supporting the declarations and facts.
See Concepts for how decided,
ratified, and proposed relate.
Then run:
deloreis check story.dli
The finding lists both values: [avalon, camelot]. The functional line tells
De Lore Is that Arthur can have only one home. Without that rule, the two
statements aren’t automatically a conflict. The command exits with status 1
because it found a problem.
To find matching homes, run deloreis query 'home($person, camelot)' --corpus story.dli.
$person is a variable; the quotes keep your shell from expanding
it. The query warns while the corpus still has errors.
Work with a world
Create a project with deloreis init my-story. To work with it through an MCP
client such as Claude Code, follow the quickstart to
connect the local server, add facts, and catch a contradiction. The walkthrough
shows how to ask the client to make the tool calls.
In a project, De Lore Is keeps the decisions behind your claims, including claims you later revise. You can keep accounts unresolved, inspect why something is considered canon, and explore changes on a separate branch. The project keeps the order in which claims and rulings were added; it does not infer what each character knew at a particular point in the story.
- Holmes casebook — follow a sourced example through conflicts, revisions, and alternatives.
- Modelling guide — choose rules and record sources.
- Bring your own notes — start from a series bible.
- Concepts — the terms used by the tools.
- Agent guide — authoring tools and session workflow.
- Contributing — working on the project.
Linux x86-64 and macOS ARM archives are available on the releases page. De Lore Is is MIT licensed.
Use with a writing assistant
Install the consumer skill with its first-session reference:
npx skills add jeffreykentjr/deloreis --skill deloreis
The canonical package teaches the local MCP workflow; it does not install the runtime. The quickstart covers that. Skill distribution and updates are recorded in agent-skill-distribution.
Browse the Holmes wiki to explore the example by person, place, or relationship.