The Map

Somewhere around chapter twelve, you can’t hold the whole book in your head anymore — which eye was grey, whether the inn had a name, when exactly the letter arrived. The Map is where Calliope holds it for you.

Facts

The Map is made of facts. A fact is one thing in your canon — a character, a location, an object, a faction, whatever you need to track. Each fact has:

• a name — its primary label;
• a kind — character and location come as defaults, but you can name any kind you like (object, faction, event…);
• aliases — the other names your prose uses for the same thing. Kata, Katarína, and Mrs. H. can all be one fact;
• attributes — plain key/value notes you declare, like eyes: grey or home: Prague;
• a summary — free-text notes on who or what it is and where it’s going.

A fact’s real identity is separate from its name — so renaming it, or giving it a dozen aliases, never loses track of what it is. That also means two different characters can share a name (a father and son both called Marcel) and Calliope treats that as perfectly normal, not an error.

Mentions

A mention is a place in your prose where a fact appears. Facts count their mentions, and a fact’s card shows where it’s referenced across the book, so you can click straight from “who is this again?” to the scenes they’re in. Mentions are anchored to the identity of the fact, not the spelling, so they survive renames and merges.

Every fact is in one of three states, shown right on the Map:

• linked — it has live mentions in the current prose (“12 mentions”);
• memory — it was mentioned once, but the prose that referenced it is gone. Calliope keeps the fact rather than silently dropping your canon;
• unlinked — you’ve noted it, but it hasn’t appeared in the prose yet.

Recognising names as you write

You don’t have to tag anything for Calliope to know your cast. As you write, the editor recognises the names and aliases already on your Map — computed live, never stored, so deleting and retyping a name just re-recognises it. Hold ⌘/Ctrl and recognised names light up; ⌘/Ctrl-click one to jump to its fact on the Map, like go-to-definition for your characters. Without the modifier held, your prose looks like ordinary prose — the recognition is quiet by default.

Detecting entities with AI

When you’d rather not build the cast by hand, run entity detection on a chapter. Calliope’s AI reads the chapter and proposes characters, places, and other entities it found — resolving variant spellings against your existing canon so Kata and Katarína come back as one proposal to merge, not two new strangers.

It only ever proposes. You review each suggestion and accept it — which creates or links the fact and anchors the mention in your prose — or reject it, which leaves no trace. Nothing is written to your Map without your say-so. Detection calls Calliope’s model, so it spends credits; see the AI companion and credits.

Tidying the cast

Long books accrete duplicates. Find duplicates surfaces pairs of facts that look like the same thing — by meaning when Calliope’s semantic layer is available, and by name similarity otherwise — and offers to merge them. A merge is deliberate and non-destructive to your canon: you choose which fact to keep, and it absorbs the other’s aliases, attributes, and every mention before the duplicate is removed. You confirm each one; nothing auto-merges. Merging is free.

You can also filter the cast list to find someone quickly, and edit any fact’s name, aliases, attributes, and summary by hand at any time — the Map is always yours to correct.

You don’t even have to open the Map to do it: ask the AI companion to rename, merge, or add an entry from chat and it makes the edit for you — the Map updates live, and your prose is never touched.

A note on how the matching works

Calliope’s better duplicate-finding uses embeddings — a semantic sense of which facts mean the same thing — and that runs when you’re signed in. The cost of computing embeddings is absorbed by Calliope; it never touches your credits. Working anonymously, or offline, the Map falls back to deterministic name matching, so duplicate-finding and recognition still work — just by spelling rather than meaning.