Quill's Chronicles Guide
Everything you need to know to chronicle your adventures. Whether you're just getting started or looking for advanced tips, this guide has you covered.
Jump to Section
Core Concepts
Chronicling Your Sessions
Sharing & Community
Tools & Integrations
Getting Started
What is Quill's Chronicles?
Quill's Chronicles is your digital companion for tabletop roleplaying games. It helps you record, organize, and share the stories from your gaming sessions, creating a living wiki of your adventures.
Quick Overview
- Bring your recording — paste a Craig (craig.horse) link, upload an audio file, or drop in a transcript. Quill doesn't record your table itself.
- Process it with Quill to transcribe the session and pull out the characters, places, and events
- Review what Quill found — confirm new entities, match repeats to existing wiki pages, check who was speaking
- Explore and share the chronicle, wiki, Weave, and Spotlight with your players or the public
Your first chronicle in three steps
A world named "Default" is created for you when you sign up (rename it any time from the Worlds page), so you can start straight away:
- Create a campaign — one per game you run. Name your party and its characters while you're there: it helps Quill tell players apart from session one.
- Add your first session — paste a Craig link, upload an audio file, or drop in a transcript, then pick a summary mode.
- Review, then explore — processing takes a while. You'll check the characters and places Quill found before anything is saved, then your wiki, chronicle, and Weave are ready.
The same three steps appear as a checklist on your Worlds page and inside a new campaign until your first session is chronicled.
Your first 3 sessions are free — granted as 7.5 pages that never expire, with every feature included and no credit card required. After that, a session is a flat $2.50 (2.5 pages), no matter how long you played, with monthly plans from $12. Reading and exploring never costs pages; only processing does.
Pricing & Pages
First 3 sessions free · $2.50 flat per session after · Plans from $12/mo · All features included
The Hierarchy
Quill's Chronicles organizes your content in a clear hierarchy. Understanding this structure helps you make the most of the platform.
Worlds
The top-level container. A World represents a shared setting—like "Forgotten Realms" or your own homebrew universe. One world can contain multiple campaigns, all sharing the same wiki of entities.
Campaigns
Your game narrative container. Each campaign represents a distinct story or adventure within your world. "Curse of Strahd" and "Storm King's Thunder" could be separate campaigns in the same Forgotten Realms world.
Sessions
Individual game meetings. Each session captures what happened during one play session, broken down into chapters with quotes and highlights from Quill's analysis.
Chapters
Segments within a session. Quill automatically breaks your session into logical chapters based on scene changes, locations, or narrative beats. Each chapter contains the quotes and key moments from that portion of the session.
Parties
The roster of player characters in a campaign. Set it up when you create the campaign (or from the session wizard) — Quill uses it to map each speaker to their character, and the party becomes the backbone of the Weave and Spotlight.
Arcs
Story threads that span multiple sessions. Arcs help you track ongoing plotlines, character development, or narrative themes across your campaign. A single session might touch on multiple arcs simultaneously.
Wiki & Entities
The Wiki is your living encyclopedia of the world. It's populated with entities—the people, places, and things that make up your story. Quill automatically extracts entities from your sessions, and you can add or edit them manually.
Entity Types
PCs and NPCs in your story
Places in your world
Factions, guilds, and groups
Groups of characters
Objects and artifacts
World knowledge and history
Significant occurrences
Hidden info (DM-only)
Relationships
Entities can be connected through relationships. These describe how characters know each other, where organizations are based, who owns which items, and more. Relationships can also include context from specific sessions where they were established or changed.
Editing the Wiki
Owners and Co-DMs can edit any entity page directly: rename it, add aliases, set a status (active, deceased…), choose pronouns for characters, and upload a portrait. A few less obvious controls:
- Lock the description — keep your own wording; the pipeline won't overwrite it on later sessions
- Pronunciation — a phonetic respelling used by the Documentary narrator
- Hidden — DM-only until you reveal it (see Access & Sharing)
- Preview as public — see exactly what players and visitors see
- Map view — the force-directed graph of the whole wiki (see Visualizations)
Visualizations
Quill's Chronicles provides interactive visualizations to help you explore your campaign's story structure, entity relationships, and narrative progression. Here's a preview of what's available.
The Weave
One zoomable chart of your whole campaign. Your party runs through the middle as a woven backbone, and everyone they meet becomes a thread that drifts in when they matter and falls away when they don't. A recurring villain is one thread, not five — when someone goes quiet for a few sessions their line fades to a dotted ghost, then returns exactly where they re-enter the story. Diamonds mark the secrets learned along the way.
Below the weave, each story arc gets a lane showing when it ran hot and when it lay dormant. Filter which kinds of threads show — characters, factions, and places by default; items and lore when you want them — pin any NPC into the cast, share the exact view with a link, or export it as a PNG or SVG straight from the chart.
See the Weave on a live campaign →Session Map
See how entities in a session are connected. Characters, locations, items, and organizations form a relationship web that grows with each session processed.
Entity Timeline
Trace any entity's journey across sessions — see where they appeared, who they interacted with, and how relationships evolved over time.
Wiki Map
The full interactive wiki map renders every entity and relationship in your world as a force-directed graph. Drag nodes, zoom in, filter by entity type, and click through to any wiki page. It's the best way to see the big picture of your campaign at a glance — explore it in your own campaign to see it in action.
Chronicling Your Sessions
Session Wizard
The Session Wizard guides you through uploading and processing a new game session. It's a 5-step process that transforms your audio recording into structured session content.
The 5 Steps
Set the session number, date, and game system, then bring your recording one of three ways:
- Craig link — paste the
craig.horse/rec/…URL. Craig is a free Discord bot that records each player on their own track, which is the most accurate path. - Audio file — MP3, WAV, M4A, AAC, OGG, FLAC, or Opus, or a ZIP of per-speaker tracks, up to 1.5 GB. Turn on Mixed audio if everyone shared one microphone.
- Transcript — a
.txtor.mdfile (up to 5 MB) with speaker names on each line.
Your party is selected automatically (or create one right there), and you choose the summary mode. The Exclude tracks, Redownload, and Reprocess controls are only for redoing a Craig session — first-timers can ignore them.
Quill transcribes the audio (or parses your transcript), works out who is speaking, and extracts the characters, locations, items, and events mentioned in the session. Processing runs in the background and usually finishes well under an hour. You can close the tab; the wizard picks up where it left off when you come back.
Nothing is written to your wiki until you say so. Two tabs: Entities, a triage list of what Quill found, and Speakers, the speaker-to-character mapping. You can skip the review, but you'll be warned — duplicates and misheard names then land in the wiki as-is.
Quill generates the session summary, breaks content into chapters, extracts quotes, and updates relationships in the knowledge graph.
Review the results and navigate to your newly created session. Your chronicle is ready!
Entity Review
The Entities tab sorts everything Quill found into three groups so you spend your attention where it matters:
- Needs your call — the handful of ambiguous identities and corrections that gate quality. Always open.
- New entities — brand-new characters, places, and things to confirm or reject. On a fresh campaign this is most of the work.
- Auto-applied — confident matches to existing wiki pages, collapsed but searchable if you want to double-check.
For each entity you decide:
- New — accept it as a new wiki page
- Match — link it to an existing page (e.g., "Blackwood" is really "Lord Blackwood"); search your wiki inline
- Exclude — drop it entirely (false positives, table talk, that one NPC who never mattered)
You can also rename, retype, add aliases, and edit descriptions before anything is saved, and keep or drop each relationship Quill proposed. A quality report at the top flags sessions that deserve a closer look.
Speaker Review
The Speakers tab shows how each recording track was mapped to a character, with the evidence behind it (line counts and example lines). Craig recordings map almost deterministically — one track per player — so this is usually a glance. If a mixed recording got someone wrong, fix the names and re-run attribution: Quill re-extracts the whole session with the corrected map, so quotes and events land on the right character rather than just being relabelled.
Find & Replace
The Entity Review step includes a powerful Find & Replace tool for bulk corrections:
- Fix misspellings - Correct names that were transcribed incorrectly
- Normalize names - Change "Bob" to "Robert" across all entities
- Target specific fields - Apply changes to names only, descriptions only, or both
- Case preservation - Replacements maintain the original capitalization
Replacements are whole-word and skip anything you've excluded. Quill also remembers the misspelling against the entity, so the same mishearing is corrected automatically in future sessions.
Progress Saving
The wizard automatically saves your progress to the cloud. If you close the browser, navigate away, or switch devices, you can resume exactly where you left off. This is especially helpful during the Entity Review step, which can take time for sessions with many entities.
If a processing job finishes while you're away, the wizard will detect it and pick up from the right step when you return.
Session Content
When Quill processes your session, it extracts several types of content to help you remember and share what happened.
Every session page opens with a title, a one-line tagline, and a Story Thus Far synopsis that keeps the campaign's running plot in one place. Below that, the session is organised into tabs:
Outline
The quick read: every chapter's factual skeleton on one screen, with an X-ray toggle that highlights the entities in the text. This is the default view on phones.
Chapters
Sessions are automatically divided into chapters based on narrative structure. Each chapter has:
- Title - A descriptive name for the segment
- Skeleton - Quick bullet points of what happened
- Summary - A narrative description of events, written in your summary mode
- Type & Subtype - Categorization (e.g., Combat, Exploration, Roleplay)
- Key moments - The reveals, decisions, and turning points inside the chapter
Not happy with a chapter? Edit chapter opens an editorial chat where you describe the change ("keep it shorter", "Mira wasn't there", "less purple") and approve a before/after preview. A rewrite costs 0.2 pages.
Quotes
Memorable dialogue from your sessions, organised by chapter. Quotes capture the voice of your characters and the funny, dramatic, or insightful moments. Each quote includes:
- Lines - The actual dialogue (can be multi-line exchanges)
- Speakers - Who said what
- Context - What was happening when this was said
You can edit any quote or add your own, and every quote has a shareable page of its own.
Narratives
The story arcs this session touched, grouped by tier — which threads advanced, which were opened, and which were resolved.
Moments
Relationship moments: the meetings, alliances, betrayals, and discoveries between entities that this session created or changed. Each one links to the entity pages involved.
Documentary
Appears once the session's recap film has been rendered — see Documentary & Spotlight.
Transcript (DM only)
The Transcript tab lays the whole recording out like a book: line numbers, a speaker index down the side, and search that jumps straight to the moment. Scroll, and the chapter list follows along — and you can save any line as a quote in one click. Transcripts are visible to the Owner and Co-DMs only, never to players or the public.
Summary Modes
When Quill processes a session, it writes through a summary mode—a narrative voice that shapes how your session is structured, titled, and told. You choose the mode when uploading a session.
The three modes form a spectrum of creative licence, from most embellished to most faithful:
The Bard (default)
Creative interpretation with literary flourishes—every beat a scene, every scene a legend. The Bard emphasizes dramatic imagery, character voice, and emotional beats, and may invent or polish dialogue to serve the story. Best when you want your chronicle to read like a novel.
The Chronicler
Literary prose, but the dialogue stays true to the transcript. A fireside storyteller's telling of the session with the players' actual words preserved — warm and engaging without putting lines in anyone's mouth.
The Scholar
Documentary style with strict transcript fidelity—the definitive record of what happened, with minimal editing and no embellishment. Best when the chronicle has to be reliable above all, or for tables who want the facts and nothing else.
Pick the mode per session in the wizard, and set your campaign's default in Campaign Settings.
What Changes Between Modes?
The same session events are covered by all three modes, but they differ in:
- Chapter titles — "The Battle of Hook Tongue" (Bard) vs "The Field of Slaughter" (Chronicler) vs "The Hammer Falls" (Scholar)
- Classification — The same chapter may be labeled a "Skirmish", "Army Skirmish", or "Mass Combat"
- Priority — Modes weigh narrative importance differently
- Narrative voice — Prose style, level of embellishment, and what details are emphasized
- Dialogue handling — Bard may invent or polish, Chronicler keeps to the transcript, Scholar quotes it strictly
See it in action: Visit the Summary Mode Demo to compare all three modes on the same session side-by-side.
Documentary & Spotlight
Two newer ways to relive a session — both included with your session, not a separate charge, tier, or upsell.
Quill's Documentary (beta)
A short narrated recap film of your session, with a single narrator voice carrying the whole episode over illustrated stills of your session's own characters and places. It lives in the session's Documentary tab: the storyboard strip under the player doubles as a seek bar, so click any beat to jump to that moment. You can download the film, the isolated narration, the narration script, and every still. Add a Pronunciation on a wiki page if the narrator keeps getting a name wrong.
Spotlight
Who held the table. Spotlight measures who did the talking — per session and across the whole campaign — with each player rooted to their character, so you can see the quiet nights, the spotlight-stealing ones, and how the table has shifted over time. Alongside the numbers sits an interpreted layer, always framed in dashed gold: what kind of scenes filled each session, how each player leaned in, and one turning-point moment per character that links back to the transcript. Tracks nobody could name pool under a single Unknown band rather than posing as a player, and a built-in guide on the Spotlight page walks through every chart.
The Documentary is still an early beta and will keep improving release over release.
Sharing & Community
Access & Sharing
Roles
Users can have different levels of access to your worlds and campaigns:
Full control. Can edit everything, manage access, delete content, and invite others.
Can edit wiki content, sessions, and entities. Cannot manage access or delete the world/campaign.
View access only. Can see all non-hidden content but cannot edit.
Privacy Modes
Each campaign has a privacy mode that controls who can view it. You can change this at any time from your campaign settings.
Only the owner and explicitly invited members can see the campaign. This is the default for all new campaigns. Use this when your chronicle is just for your table.
Any logged-in Quill's Chronicles user can view the campaign. Useful for sharing with the broader TTRPG community while keeping some visibility control.
Anyone can view—no account required. Perfect for sharing your chronicle on social media, forums, or with friends who don't have an account yet.
A world inherits the most permissive access level among its campaigns. If any campaign is Public, the world's shared wiki is also publicly viewable.
Hidden Content
Regardless of privacy mode, individual entities and relationships can be marked as hidden. Hidden content is only visible to Owners and Co-DMs—never to Players or public viewers. This is perfect for DM notes, unrevealed plot twists, or information players haven't discovered yet.
Inviting Members
Invite players and co-DMs to your campaign with invite links from Campaign Settings. Each link carries a role (Player or Co-DM), is single-use, and expires after 7 days — generate a fresh one per person. Owners can invite anyone; Co-DMs can invite players.
Sharing Public Links
When your campaign is set to Login Required or Public, you can share direct links to the campaign, its wiki, any entity or quote, any session chronicle, and the Weave. These pages are read-only and styled for easy sharing with your community — the Share button on each page copies the link.
Referrals & Gifts
Share Quill's Chronicles with your fellow adventurers and earn free pages in the process. You can also gift pages or subscriptions directly to other players.
Referral Codes
Every subscribed user gets a unique referral code on their Billing page. When someone redeems your code they receive 5 free pages instantly — and you receive 5 pages when they start their first paid subscription.
- Find your referral code on the Billing page (format:
REF-XXXX-XXXX) - Share it with a friend
- They redeem the code on their Billing page and get 5 pages right away
- When they subscribe, 5 pages are credited to your account too
Each person can redeem your code once, and a code can earn its owner up to 50 pages in total.
Gift Page Packs
Want to give a fellow player or DM the gift of chronicled adventures? You can purchase page packs as gifts from the Billing page.
| Pack | Pages | Price |
|---|---|---|
| Top-up | 5 | $5.50 |
| Casual | 15 | $15.75 |
| Enthusiast | 30 | $28.25 |
| Pro | 60 | $56.00 |
- Toggle "Gift Pages" mode on the Billing page
- Select a pack and complete checkout
- You'll receive a single-use gift code (format:
PAGES-XXXX-XXXX) - Share the code with the recipient
- They redeem it on their Billing page and the pages are instantly credited
Gift Subscriptions
Gift subscription codes grant the recipient a free subscription for 1, 3, 6, or 12 months. When redeemed, the code applies a full discount at checkout so the recipient pays nothing for the gifted period.
Gift subscription codes use the format GIFT-XXXX-XXXX.
Creator & Promo Codes
Found us through a creator we sponsor? Their code gives you a free extra session on top of your first three. Arrive via their link and the code is prefilled on your Billing page after sign-up — or type it in yourself. One redemption per account.
Redeeming Codes
All codes—referral, creator, gift pages, and gift subscriptions—are redeemed from the Redeem Code section on your Billing page. Simply paste the code and the reward is applied to your account.
Tools & Integrations
Export Formats
Your data is yours. Export your campaigns in multiple formats from the Wiki page or from individual entity pages.
Campaign Exports
From the Wiki index page, open the export menu to download your entire campaign:
A ZIP of Markdown files with YAML frontmatter, Dataview-compatible metadata,
and [[wikilinks]] for Obsidian's graph view. Entities are organized into folders by type. Drop the
extracted folder into Obsidian and your campaign is ready to explore.
A ZIP of standard Markdown files with no Obsidian-specific syntax. Readable in any Markdown viewer—VS Code, GitHub, Notion, or a plain text editor. Same folder structure as the Obsidian export.
A single structured JSON file containing all entities (with relationships), sessions (with chapters), and story arcs. Ideal for building custom tools, data analysis, or migrating to another platform.
Individual Entity Export
From any entity page, use the download menu to export that single entity as Obsidian Markdown, plain Markdown, or JSON.
Permissions: All exports respect your role. DMs and Co-DMs see everything including secrets. Players see only non-hidden content.
MCP Integration
Quill's Chronicles provides an MCP (Model Context Protocol) server that lets AI assistants query your campaign data conversationally. Ask questions about your world, roll dice, and explore your story—all from within your favorite AI tool.
Connect with Claude
- Open Claude at claude.ai
- Go to Settings → Connectors
- Click Add Connector and enter:
quillschronicles.com/mcp - Authorize with your Quill's Chronicles account
- Start asking questions about your campaigns!
Connect with ChatGPT
- Open ChatGPT at chatgpt.com
- Go to Settings → Connected apps
- Click Add and search for Quill's Chronicles, or enter:
quillschronicles.com/mcp - Authorize with your Quill's Chronicles account
- Ask GPT about your campaigns using the same tools!
What You Can Do
Once connected, your AI assistant has access to 37 read tools across 6 categories — plus write tools for campaigns you own or co-DM:
Browse worlds, campaigns, sessions, and entities
Query by timeline, session ranges, temporal IDs
Explore entity relationships and story arcs
Statistics, summaries, and network analysis
Search and read session dialogue
Dice roller and oracle for gameplay
Editing Your World From Claude
For campaigns you own or co-DM, the MCP server also exposes write tools: create and update entities, link or archive relationships, merge duplicates, and run a bulk find & replace. Every change is previewed first and waits for your confirmation before it touches your graph.
Example Queries
- “ What happened to Thordak in our last session? ”
- “ Roll initiative with advantage and +3 modifier ”
- “ Ask the oracle: Does the merchant have the artifact? ”
- “ Show me all relationships involving the Thieves Guild ”
- “ Summarize the events from sessions 5-8 ”
Dice Roller
Roll dice using standard notation with support for advantage and disadvantage:
1d20+5— Standard roll with modifier2d20kh1+3— Advantage (roll 2, keep highest)2d20kl1-2— Disadvantage (roll 2, keep lowest)4d6kh3— Stat rolling (roll 4, keep highest 3)
Oracle
Ask yes/no questions and get narrative-flavored answers:
| Roll | Result | Meaning |
|---|---|---|
| 1 | No, and... | Doesn't happen + complication |
| 2 | No | Simply doesn't happen |
| 3 | No, but... | Doesn't happen + silver lining |
| 4 | Yes, but... | Happens + cost or catch |
| 5 | Yes | It happens |
| 6 | Yes, and... | Happens + unexpected boon |
Note: AI assistants only see worlds and campaigns your account has access to. Read tools never change your data, and write tools work only on campaigns you own or co-DM — with every change confirmed by you first.
Discord Bot
Invite the Quill's Chronicles bot to your Discord server and your players can ask Quill questions about the campaign right where you play. Answers come from your campaign's knowledge graph — not from generic AI knowledge. The bot is in beta.
- Invite the bot from the Integrations page
- Create a chat token in Campaign Settings → Integrations
- Run
/connectin your server and paste the token
The Integrations page is also where you'll find the MCP setup and export options.
Join the Community
Have questions, feedback, or just want to chat with fellow chroniclers? Join our Discord server for support, feature discussions, and to share your campaign stories.
Join our DiscordYou can also email us at quill@quillschronicles.com.