Changelog
Track Grimoire's evolution. New features, improvements, and fixes.
Grimoire 1.5.2: The Knowledge Graph Overhaul
v1.5.2September 11, 2026
The Timeline and Geography graphs were rebuilt from the canvas up. The Timeline became the Braid: packed lanes that fit a long campaign without scrolling, session cards you can read at a glance, and a trail that lights up every session an entity appeared in. Geography stopped requiring map images: your places now draw themselves as nested boxes or a tidy tree, with the pin-on-image Atlas re-homed as a map mode any location can open. Session observations became a real feature you can read and edit, and Grimoire MCP learned to write them. Next up: custom entity graph improvements, and a UI and UX pass on the player portal.
- added The Timeline is now the Braid: story arcs, session cards and open threads pack into lanes that fit a long campaign on one screen, with a Session detail toggle that expands each card and a preference that remembers how you like it
- added Entity trail: pick an entity from a session card and every session it appears in lights up, with a rail drawn through the spine, built from the links your recaps already carry so there is nothing to author
- added A Trace entity button with a filterable list, and a labelled Clear trail control, so following one character through the campaign no longer means hunting for the right card first
- added The Open Threads panel gained a Resolved tab, so closed threads stay readable instead of disappearing
- fixed Sessions order by session number and then by date, so a campaign whose sessions have no calendar dates no longer appears in a scrambled order on the Timeline
- changed Thread colours were re-stepped to a colourblind-safe set (Promise and Mystery were nearly identical before), and every place that drew thread colours now reads the same canonical palette
- removed The old Timeline renderer and its Connect tool were retired along with hand-drawn timeline connections, which never reached AI clients and are replaced by the entity trail
- added Geography works without a single map image: your places draw on the canvas as Nested places, folding containment boxes you can open full-canvas, or as a Tidy tree, with a density toggle, a legend and a details drawer
- added Every location can open a map mode, so the pin-on-image Atlas now lives per place, keeping its tools, zoom, pins, markers and uploads, reached with Open map or Add a map
- added An always-visible Unplaced band shows the places that sit nowhere yet, and the details drawer can set a parent without leaving the canvas
- added Pinning a place onto another place's map now records the hierarchy: a place with no parent is placed silently, and one that already lives somewhere else asks first, naming all three places, because everything inside it moves too
- changed The map placement list now offers everything directly linked to that place, the places inside it plus its NPCs, creatures and factions, uncapped, and each one can be placed by dragging or from the keyboard
- changed Location types read at a glance: four scale tiers, from cosmos down to site, each with its own shape and short tag, checked for colourblind and contrast safety, and genre preset types are mapped onto the same tiers
- changed Your place on the Geography canvas rides the address bar: the selected place, the open box and map mode all survive a refresh or a shared link, and layout and density persist per browser
- fixed A location's full description now reads in the Geography details drawer instead of being cut short; the canvas still shows a trimmed line, where there is no room for more
- removed The Locations page tree view was retired in favour of the Geography lens, which does the same job better; a saved tree preference falls back to the table
- added Session observations, the notes that colour a session, are now readable and editable where you would expect them: clicking a session opens its details with every observation listed in full, with add, edit and remove
- fixed The AI narrative state only reports observations attached to the sessions it is summarising, instead of falling back to older ones from sessions nobody is looking at
- added Grimoire MCP: AI clients can create, edit and remove session observations, so a note worth keeping can be marked while prepping or writing up a session instead of only by hand afterwards
- added Grimoire MCP: pins on a location map now read as links in the geography graph for GM connections, so where a character or creature was found is something the AI can follow, without those pins appearing as links anywhere else
- changed An observation type outside the four Grimoire offers is now refused by name rather than stored, so an AI client cannot quietly invent a category
- security Editing or deleting a session observation or a story arc now verifies it belongs to the campaign you are working in
Grimoire 1.5.1: Wiki Page Links, Tables, and a Sharper Grimoire MCP
v1.5.1September 1, 2026
The wiki learned to link, table, and stay honest about who sees what. Type [[ to link any page mid-sentence or create one on the spot, drop a simple table with /table, and mention entities with @. Visibility now resolves exactly the way it reads, and Grimoire MCP caught up to all of it: AI clients can read and write tables, search the wiki by text, and are held to the same boundaries as the app.
- added Inline page links: type [[ anywhere in the wiki to link an existing page or create a new one mid-sentence; links render as chips that follow the page title
- added Simple tables in the wiki: /table drops a grid with a header row, and the block handle menu has a Table group for adding or deleting rows and columns
- added @ entity mentions in the wiki editor: link NPCs, locations, and any other entity inline, with names that stay current when the entity is renamed, and create a matching entity on the spot when the name is new
- changed Wiki visibility resolves end to end the way it reads: a page inherits from the block that links it, then its parent chain; player-knowledge admits exactly the listed players; an unreachable page is invisible everywhere, including search, mentions, and backlinks
- changed Root wiki pages no longer sit at inherit: existing ones were promoted to common knowledge, so a whole wiki can no longer hide behind an unset toggle
- changed The link index tracks inline page links and sheds references to deleted targets, so "Linked from" stays truthful
- added Grimoire MCP: AI clients can create and edit wiki tables as plain markdown grids and read every table back the same way, with entity and page links working inside cells
- added Grimoire MCP: a new search_wiki tool searches page titles and content under the same visibility rules the app enforces
- fixed Grimoire MCP: batch entity creation works from every AI client (the entities parameter was declared with the wrong schema type, so strict clients could never call it), and tags are no longer dropped silently on create and update
- changed Grimoire MCP: every wiki tool description was rewritten against current behavior, block writes validate their type and shape, and replacing the Campaign Bible can no longer lose content if a write fails midway
- security Grimoire MCP wiki access is scoped to the campaign wiki space with uniform not-found responses, deleting a page card tidies up its page exactly like the app does, and the Campaign Bible title block is protected from deletion
- changed Grimoire MCP: every thread reports its status, and resolving a thread records the closing progression on its own so the timeline and thread history stay complete from any client
- fixed Threads created or resolved through the API or Grimoire MCP now carry their start and resolution progressions; existing threads with a linked session were backfilled
- changed Key events can be marked important and canonical from both the session form and the sessions table, and their order follows the list
- changed Search now covers every text field on an entity, and as the GM it also finds matches in your GM-only notes and custom fields (players never match on those)
- changed Custom fields can be marked GM Secret in Campaign Settings: a secret field's value stays out of every player read, in the app and over Grimoire MCP, exactly like the built-in GM Secret fields, and a value left behind by a deleted custom field stays GM-only until the field is defined again
- changed Grimoire MCP: get_narrative_state now carries each recent session's GM-only consequences and behind-the-scenes notes for GM connections, so understanding why something happened no longer takes a separate read per session
- fixed Grimoire MCP: get_relationships no longer lists a faction membership twice and now labels incoming junction rows with the right target category
- changed Grimoire MCP: the compact graph maps in get_entity_catalog and the Layer 1 read now use the same edge vocabulary and sources as get_knowledge_graph, so NPC-to-NPC relationships, rivalries, and primary faction memberships appear everywhere; geography edges read located_in from child to parent
- fixed Grimoire MCP: Layer 1 graph structures return an empty edge list instead of null when no attention entities are connected
- changed Grimoire MCP: get_knowledge_graph timeline now links each session to the NPCs, locations, quests, loot, creatures, PCs, planar forces and lore it touched
- fixed NPC relationships you record now show up on the Political Web without adding each character to the graph by hand
- fixed The campaign tone line stops repeating itself: a genre facet that restates its base genre word for word no longer contributes the same clause twice, on the campaign home header and everywhere Grimoire MCP reports campaign context
- changed Graphs now place your entities for you by default: the Political Web, Timeline, and Geography fill in as you build the world instead of starting empty, and the graph settings panel still offers Manual if you would rather add every entity by hand
- added A faction's leader and an NPC's superior now show as their own connections on the Political Web, so a chain of command appears without adding either side to the graph by hand
- changed Filing a session recap now places the people and places it names on the graphs: the NPCs and player characters join the Political Web and the locations join Geography
- added Session recaps can record the factions involved, and filing one places those factions on the Political Web and the timeline
- fixed The Add Custom Field dialog opened from a database table no longer sits beneath the table's Title column header
- fixed Graph settings save on the first change again: the second-toggle quirk after opening a graph's settings panel is gone, and a never-configured graph no longer switches itself off the first time its settings open
- fixed Custom graphs draw the location hierarchy and quest connections they always promised: parent locations, quest NPCs, quest locations and quest items now appear as edges
- fixed Geography "All depths" really shows every level; the projection was silently capped two levels below the roots
- fixed Pinning a player character, session prep, world rule, deity or mechanic on a location map no longer fails
- changed A location can no longer be placed inside itself or one of its own descendants
- changed Saving an NPC, location or deity form keeps the details other tools recorded on its relationships (relationship type, strength, notable flags) instead of resetting them
- added Session recaps can name the NPCs, locations, quests, loot, creatures, player characters, deities, lore and factions involved while being created, not only when edited, and creating one places those entities on their graphs right away
- changed Grimoire MCP: timeline nodes carry each session's stored session number, and the attention view no longer includes custom connections whose endpoints are outside it
- changed Grimoire MCP: player-role graph reads no longer include an entity's status or its relationship to the party, and GM-drawn custom connections are GM-only
- changed Grimoire MCP: marking an entity through toggle_graph_attention now sticks, exactly like marking it in the app
- removed The unused per-location attention sliders on Geography were removed; attention on graphs is unchanged
Grimoire 1.5: The UX Revamp
v1.5.0July 9, 2026
The biggest release since launch. Player accounts are now real Grimoire accounts: one login for the worlds you run and the worlds you play in, with invite links that join a campaign in one click. On top of that, nearly every surface was rebuilt: a warm new visual identity, a unified sidebar, an entity peek drawer, denser tables, a restructured wiki, one Graphs workspace, and settings that finally live inside the app.
- added Unified accounts: players sign in with a regular Grimoire account and hold a per-campaign role, so the same login runs your worlds and plays in your friends' worlds
- added Invite links: share a /join link and players see a campaign preview and join in one click; the campaigns page gains a "Playing in" shelf and a join-first path that skips campaign creation
- added Entity peek drawer: every entity reference opens a side sheet with full details, connections, and everywhere it appears; drawers are URL-addressable and the browser Back button steps through your chain
- added One Graphs workspace: World Foundations, Political Web, Timeline, Geography, and your custom graphs live as tabs on a single surface, with on-canvas entity adding
- added Wiki search across page titles and content, plus a Wiki mode in the command palette
- added Wiki right rail with an on-page table of contents and the entities mentioned on the page
- added Wiki Home page and a GM Trash panel: the root page cannot be deleted, Clear cascades safely with a hard warning, and trashed pages can be restored
- added Threads can link a quest: linked quests show as chips on dashboard thread cards and in the palette, and resolving a linked thread prompts about the quest
- added Campaign settings rebuilt inside the app shell: four focused tabs, portal policy cards that show exactly what players will see, and a live plan card with founders pricing
- added MCP activity log now records every tool call with user attribution, visible on the Knowledge tab
- changed New visual identity: warm umber and gold palette, serif display type, border-defined cards, and denser tables that fit half again as many rows above the fold
- changed Unified navigation: one sidebar carries your whole world including the wiki page tree, and the topbar with breadcrumbs and search now spans databases and wiki alike
- changed Dashboard rebuilt: on-stage entities, thread cards, and the chronicle are all clickable and open the peek drawer in place
- changed Player portal respects your reveal settings end to end: revealed-world players get full sidebar navigation while wiki-only players keep a focused reading layout
- fixed Undo and redo now work in collaborative wiki editing sessions
- fixed Tables always fill their available width, the column picker scrolls without closing, and row hover actions fade correctly
- removed The Pin Board: the rebuilt dashboard and denser tables now cover what it did, better
- removed Separate player logins: existing invite flows now create standard accounts
- security Collaborative wiki sessions now verify campaign membership server-side before opening a connection
Genre System: Base Genres, Facets, Dimensions, and the Vehicles Entity Type
v1.4.0May 18, 2026
Grimoire is no longer fantasy-only. Campaigns now pick a base genre, stackable facets, a ruleset, and structural dimensions, so a sci-fi or horror campaign stops inheriting fantasy vocabulary. Vehicles joins as the 14th entity type, and paid campaigns can define their own typed custom fields on any category.
- added Seven base genres (Fantasy, Sci-Fi, Post-Apocalyptic, Horror, Modern/Urban, Superhero, Historical) that reskin field-option vocabularies, display names, default categories, and AI tone
- added Stackable, additive-only genre facets (Horror, Cyber, Survival, Mystery, War, Mecha, and more) that append field options, tags, and tone without renaming or removing anything
- added Vehicles: the 14th entity type for starships, airships, war rigs, and getaway cars, available now via the REST API and Grimoire MCP
- added Per-campaign ruleset field (e.g. "D&D 5e", "Mothership 1e") persisted and surfaced to the AI as mechanical scaffolding
- added Dimension registry: toggle dimensions (Higher Powers, Vehicles) gate entity categories; spectrum-2d dimensions (Technology, Magic) capture a setting's ceiling and prevalence independently
- added Updated campaign creation flow: a short, genre-defaulted wizard for name/description, system picker, and dimensions
- added Settings UI to change genre, facets, ruleset, and dimensions after creation, non-destructively
- added MCP campaignContext block and a get_campaign_context tool so AI clients receive the campaign's genre, ruleset, and dimensions
- added Custom fields: define your own typed fields (text, long text, number, boolean, date, select) on any of the 14 entity categories from a Custom Fields tab in Campaign Settings (paid plans)
- added Custom fields appear automatically in every entity create and edit form and on detail views, and ride to AI clients in the MCP campaignContext block
- fixed update_entity now merges custom field values instead of replacing them wholesale, preventing data loss when an AI client updates an entity
- changed Per-campaign entity-category enable/disable enforced in MCP reads and writes: disabled categories are omitted from reads and rejected on writes
- changed Existing campaigns backfilled to the Fantasy genre with identical vocabulary; the fantasy path is behavior-identical to before
Grimoire MCP: OAuth 2.1, Streamable HTTP, Directory-Ready
v1.3.0May 13, 2026
Connecting Grimoire to Claude is now a one-click flow. The MCP server moved to the current spec (streamable HTTP transport, OAuth 2.1 with PKCE, JWT access tokens) and is ready for submission to the Anthropic Connectors Directory.
- added Streamable HTTP MCP transport at /mcp (replaces SSE per the 2025-06-18 spec)
- added OAuth 2.1 authorization server with PKCE, dynamic client registration (RFC 7591), and JWT access tokens (RS256)
- added Consent screen showing which AI client wants access, requested scopes, and a campaign picker bound to your account
- added Well-known discovery endpoints (RFC 8414, RFC 9728) and JWKS for public-key verification
- added Token revocation and rotated refresh tokens; access tokens audience-bound to the MCP server URI
- added Explicit read-only / destructive / idempotent / open-world annotations on all 34 MCP tools
- added Privacy policy section detailing exactly what AI assistants see and how to revoke access
- changed Connecting Claude no longer requires Node.js, mcp-remote, or editing claude_desktop_config.json — paste the URL into Claude's "Add custom connector" and sign in
- removed Legacy SSE transport at /api/v1/mcp/{campaignID}/sse and the mcp_api_tokens bearer-token flow (the admin UI for token CRUD remains for now)
Free Tier Expansion + Grimoire MCP Brand Refresh + Blog Launch
v1.2.0May 7, 2026
Free tier no longer caps your campaign at 25 entities, the AI integration is now branded "Grimoire MCP," and a long-form blog is live.
- changed Free tier no longer enforces a 25-entity cap — Pro features remain Pro, but the world-size limit on Free is gone
- added Public blog with content collections, full SEO schema, and topic filtering
- added Long-form explainer post on layered context in Grimoire MCP
- added New hero demo video on the landing page with structured VideoObject metadata
- added MCP page rewritten around horizontal flow diagrams with tab switching and human-readable tool descriptions
- changed Site-wide language audit: "AI integration" → "Grimoire MCP" wherever it fits the product narrative
- changed Homepage title set to "Grimoire | For Gamemasters"; OG image + favicon overhauled
- fixed Legal contact links route to the live domain
Narrative State, Graph UX, and Full SEO Stack
v1.1.0February 26, 2026
Open Threads track promises the party has made, the knowledge graph got real edge editing, and the public site moved to Astro for search-engine indexing.
- added Open Threads: track unresolved obligations the party has, with progression notes that anchor them to session recaps and a stable per-progression UUID
- added Thread progression timeline UI with status transitions (resolved / unresolved) and rich session-anchored notes
- added Eras context for shared timeline state across the app
- added Knowledge graph edge editing: select edges, edit them inline, drop new ones via a dropdown, with arrowheads and a dedicated edge view panel
- added Campaign Bible MCP tools and graph visualization for the bible structure
- added Inline editing for quest objectives
- added New graph-first landing page concept at /v2
- changed Migrated all static/marketing pages from the React SPA to Astro-generated static HTML so they index properly in search engines
- changed Full SEO foundation: page-level meta tags, robots.txt, sitemap.xml, JSON-LD structured data, GA4 tracking, Google Search Console verification
- added Resources nav section and a Careers page
- fixed Token refresh race conditions, knowledge-graph visibility filtering (security), and a stack of dependency-cleanup work from internal code review (batches 1-7)
Grimoire V1.0 - Official Launch
v1.0.0January 22, 2026
Grimoire is now live! Full-featured campaign management platform with AI integration, real-time collaboration, and subscription billing.
- added Stripe subscription billing with Free, Pro, Pro+, and Team tiers
- added Real-time collaborative wiki editing with Y.js sync
- added Public documentation hub with quickstart guides
- added Image upload and management for entities and wiki pages
- added Public shareable links for wiki pages and Player Portal
- added Interactive map layers with location pins
- added Landing page with product demo video
- changed Upgraded to production domain (ttrpg.bot)
- changed Improved OAuth flow with Google and Discord
- fixed Subscription checkout flow for both OAuth and email login
- fixed Navigation anchor links for same-page scrolling
Subscription System & Player Authentication
v0.9.0December 30, 2024
Added tiered subscription plans and separate player authentication for the Player Portal.
- added Subscription tiers: Free, Pro, Pro+, and Team plans
- added Player authentication with invite codes
- added Entity limits based on subscription tier
- added GM preview mode to see player view
- changed Landing page pricing section with tier comparison
- fixed Login redirect issues on development environment
MCP Server & AI Integration
v0.8.0December 15, 2024
Full MCP server implementation allowing AI assistants to query and modify campaign data.
- added MCP server with 20+ tools for campaign management
- added Claude Desktop integration guide
- added AI context tiers for efficient data loading
- added Campaign Bible for AI behavior guidelines
- added World Foundations for immutable campaign truths
- changed Improved entity search for AI queries
Block-Based Wiki Editor
v0.7.0December 1, 2024
New wiki system with block-based editing and database entity embedding.
- added Block-based rich text editor
- added Embed database entries in wiki pages
- added Wiki page versioning and history
- added Cross-linking between wiki and database
- changed Improved typography and reading experience
- fixed Editor performance with large documents
Knowledge Graphs & Visualizations
v0.6.0November 15, 2024
Interactive relationship maps for NPCs, factions, and locations.
- added Political web visualization for factions
- added NPC relationship graph with connection types
- added Geographic hierarchy tree view
- added Timeline visualization for campaign events
- changed Graph layouts now saveable per campaign
Multi-Campaign Support
v0.5.0November 1, 2024
Manage multiple campaigns from a single account with campaign switching.
- added Campaign selector in navigation
- added Campaign-scoped data isolation
- added Campaign settings and configuration
- added Campaign duplication and templates
- changed Dashboard shows per-campaign statistics
Database Views & Filtering
v0.4.0October 15, 2024
Multiple view modes for databases: table, gallery, and custom views.
- added Table view with sorting and filtering
- added Gallery view for visual browsing
- added Custom field visibility per view
- added Saved filters and views
- changed Improved mobile responsiveness for tables
Core Database Schemas
v0.3.0October 1, 2024
Initial implementation of 13 TTRPG-specific database schemas.
- added NPC database with relationships and stats
- added Location database with hierarchy support
- added Faction database with goals and rivalries
- added Quest database with objectives and progress
- added Item, Creature, Lore, Session databases
- added Full-text search across all entities
Authentication & Dashboard
v0.2.0September 15, 2024
User authentication and initial dashboard implementation.
- added OAuth authentication (Google, Discord)
- added User dashboard with campaign overview
- added Recent activity feed
- added Quick access navigation
Initial Release
v0.1.0September 1, 2024
First public alpha release of Grimoire.
- added Landing page and marketing site
- added Basic project structure
- added Design system foundation