Skip to content

dohr-michael/quill

Repository files navigation

Quill

A companion for tabletop RPG Game Masters. Take notes without leaving the table, query 20 rulebooks without flipping through them, and turn raw session logs into clean chronicles while you're still putting the dice away.

Également disponible en français : README.fr.md.

The problem

Running a tabletop RPG means juggling three streams at once: the fiction (what's happening at the table), the canon (the rules, the lore, the 800 pages of the core book) and the instance (your campaign — your NPCs, your locations, your house rules, the timeline nobody can ever remember). Existing tools force you to pick one: a frozen wiki, note-taking without context, or a heavyweight VTT that imposes its own structure.

Quill takes the opposite bet: everything stays in markdown, in a folder, under git. Readable without tooling. Editable in any editor. Diffable, reviewable, shareable.

Principles

  • Markdown first — the source of truth is the file, not a database.
  • Git-friendly — one campaign = one repo. Versionable, forkable.
  • MCP-native — the core exposes MCP tools consumable from Claude Code, the Quill TUI, or your own client.
  • Canon vs Instance — strict separation. Instance wins over canon when they contradict (your house rules always beat the book).
  • Progressively system-agnostic — V1 targets Vampire: The Masquerade V5; the architecture supports any system.

What you can do with it

  • Take notes on the fly during the session, with [date:...] [location:...] tags that propagate intelligently.
  • Query canon + instance together: "what are the hunting rules?" → sourced answer with page citations.
  • Post-session: extract the entities mentioned, update the timeline, generate missing stat blocks — the agent proposes, the GM approves.
  • Roll dice and interpret results in the system's own vocabulary (VtM critical successes, bestial failure, etc.).

Status

Rust MVP exposed as an MCP server. Usable from Claude Code today. A desktop app (Tauri + React) unifying read, edit and terminal is in progress.

Going further

  • Detailed specdocs/vision.md: file formats, MCP tool specs, PDF → markdown pipeline, RAG chunking strategy.
  • Technical contextCLAUDE.md: crate architecture, build commands, invariants.
  • Roadmapbacklog/.

License

Open-source code. Licensed corpora (rulebooks) are not included.

About

Quill est un compagnon CLI pour Maîtres du Jeu, conçu pour la prise de notes en session, l'interrogation d'un corpus de règles et de lore, et la structuration post-session des données de campagne.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors