Skip to content

kbennett2000/chronicle

Repository files navigation

Chronicle — your personal, private Dungeon Master

Chronicle

Your personal, private Dungeon Master — right on your own computer.

Chronicle is a beautiful, mobile-first solo Dungeons & Dragons app. A patient AI storyteller runs the game, remembers every detail of your world, and keeps perfect continuity from one session to the next. You play from your phone or tablet; everything stays private on your home Wi-Fi.

It feels like opening a leather-bound journal with warm parchment pages and candlelight — a Dungeon Master who is always ready, never gets tired, and never forgets what happened last time.

The story screen on a phone Illustrations of your world Your character sheet

Get started

Chronicle works on Windows, Mac, and Linux. Setup takes about 20–30 minutes the first time, and you only do it once. Pick your computer and follow the simple, picture-guided steps:

New here and not sure where to begin? Start with the User Guide — it walks you through everything, one calm step at a time.

What you'll need

  • A Windows, Mac, or Linux computer (laptop or desktop)
  • A phone or tablet on the same home Wi-Fi
  • A Claude account (a Claude Pro or Max subscription powers the storyteller — the guide shows you how to sign in)
  • About 20–30 minutes the first time

Configuration

Chronicle reads its settings from two JSON files at the repo root — config.json for non-secret settings and secrets.json for passwords (both git-ignored). You don't have to create them to start: a fresh checkout boots from the committed defaults. To change anything, copy the templates and edit:

cp config.example.json config.json
cp secrets.example.json secrets.json

See the Configuration guide for every setting, the settings-vs-secrets split, and how to point image generation at a remote GPU host.

Learn more


Your stories stay safe and private — nothing ever leaves your home network.

Ready to begin? Pick your computer above and let's get your personal Dungeon Master set up. You've got this. 🕯️

Building on Chronicle or curious how it works? See the Developer & Architecture Guide.

About

Your personal, private AI Dungeon Master — a mobile-first solo D&D 5e app whose file-backed Claude Agent SDK engine remembers every NPC, quest, and dice roll, with optional Grok-generated scene art. Runs entirely on your own home network.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors