chronicler-ttrpg 0.1.0

Local-first CLI for turning tabletop RPG session exports into an Obsidian campaign vault

Chronicler

Chronicler is an AI agent that turns tabletop RPG session recordings into a living Obsidian campaign vault. Feed it session PDFs or transcripts, and it extracts NPCs, locations, factions, plot threads, and key events — then writes linked notes you can actually use at the table.

macOS only. The Obsidian integration depends on the macOS desktop app.

Install

pip install chronicler-ttrpg

Then run the setup wizard:

chronicler config init
chronicler init

See docs/installation.md for prerequisites and a step-by-step walkthrough.

Quick Start

# Add your player characters
chronicler party add --player "Alice" --character "Nyra" --class "Wizard"

# Ingest a session
chronicler ingest --session 1 /path/to/session-01.pdf

# Review the vault
chronicler review
chronicler ask

The Quick Start guide walks through your first session end-to-end.

Documentation

Guide	Contents
Installation	Prerequisites, install options, initial config
Quick Start	First session walkthrough
Command Reference	Every command, flag, and example
Configuration	All settings and environment variables
Workflows	Backlog processing, active campaign, knowledge import
Troubleshooting	Common errors and fixes
Development	Dev environment, tests, contributing

License

GNU AGPL v3 or later — see LICENSE.