Where Was I? Save Companion

⭐ Gold Star Project I consider this project complete. Fixes, maintenance and good new ideas are still welcome. About Gold Stars

Save notes about where you left off in a game, and make a copy with private details removed when you want to share it.

What you can do

• Keep local cards with progress, reminders and return-to-game notes.
• Create, duplicate, edit or remove cards in the browser and save them as a new file.
• Compare saved cards after applying the chosen privacy settings.

Current release 1.3.0

Create a first card from an empty file ({"version": 1, "cards": []}), add another card, duplicate one with a generated unique ID, or remove one after confirmation. The browser updates game headings and printable values together. List fields use one item per actual line.

Edits stay only in the current tab until you download the new JSON file. Closing or reloading a changed editor prompts before leaving; printing does not save changes or clear the warning. No browser storage or network sync is added. Starting a download keeps the warning active because saving can be canceled. After saving the current JSON file, choose I saved the download to clear the warning. Editing, adding, duplicating or removing a card disables that acknowledgment until you export the current state again. IDs must be unique and required fields nonblank before download or the Print cards action. You can remove all cards and download a valid empty collection.

New and duplicated cards respect the HTML's selected privacy mode: default omits private notes, --share-safe also excludes screenshot references and unknown fields, and --include-private explicitly enables private notes. Retained text can still be sensitive. After editing a comparison page, its original comparison is hidden; download the new cards and regenerate the comparison with the CLI. Sources and existing outputs remain unchanged.

Duplicate-ID protection in 1.2.2

The browser editor blocks duplicate card IDs before download and explains how to correct them. Required fields must remain nonblank. After correcting an ID, download the edited cards and reopen them with the CLI.

Updates in 1.2.1

Comparisons now tell the difference between booleans and numbers, even inside nested values.

JSON true differs from 1 and false differs from 0, including inside nested metadata. Numeric 1 and 1.0 compare equally; object key order does not matter, while array order does. Existing field-presence and privacy rules still apply.

Updates in 1.2.0

Compare two saved sets of game cards using the same privacy settings for both.

Use where-was-i current.json --compare previous.json --share-safe --format html --output comparison.html. Both files must be version 1 card inputs. Comparison covers full files and cannot be combined with --game. Default comparisons omit private notes; --share-safe additionally removes screenshot references and unsupported fields from both sides, including removed and added cards. --include-private is explicit and incompatible with --share-safe. Retained goals, location and story text still need review. Changing an ID appears as removal/addition; neither input is modified.

Where Was I? Save Companion turns a small local JSON file into private return-to-game cards. Each card keeps the practical context that save files usually omit: current location, immediate goals, controls worth remembering, story context, loose ends, and the next action.

Three-minute start

python -m pip install .
where-was-i examples/cards.json
where-was-i examples/cards.json --game "North Road" --format json

Cards can carry a spoiler boundary and a private note. Markdown reports omit private notes unless --include-private is explicitly supplied. Existing output files are never replaced.

The tool does not inspect game saves, synchronize accounts, infer story state, or verify that a note remains accurate. The JSON file is the source of truth and may contain spoilers or personal notes, so store and share it accordingly. Requires Python 3.10 or newer.

Part of the Logan Pendragon Forge open-source collection. Licensed under the MIT License.

Updates in 1.1.0

Add editable printable return-to-game cards, last-played and screenshot references, and explicit share-safe exports with omission previews.

where-was-i examples/cards.json --format html --output return-cards.html

HTML edits card fields and downloads a new version 1 input; print layout includes full field values. last_played is an ISO date, screenshot_reference is a text attachment reference, and save_catalog_id optionally points to an operator-chosen catalog record. Neither images nor saves are opened. --share-safe works with Markdown, JSON and HTML: it omits private notes, screenshot references and unsupported extension fields, reporting counts without copying omitted values. Retained location, goals and story text still need review before sharing. --include-private is incompatible with --share-safe. Default reports continue to omit private_note. Source files and existing outputs remain unchanged.

The local card editor requires unique card IDs before download. If an edit duplicates another card ID, correct it and download again; required fields must also remain nonblank.