From ae96a9bab486ec9bceb0549743f65fa9faadd5e2 Mon Sep 17 00:00:00 2001
From: Keith Solomon <keith@vincentdesign.ca>
Date: Wed, 8 Jul 2026 07:56:16 -0500
Subject: [PATCH] =?UTF-8?q?=F0=9F=93=84=20docs:=20Add=20readmes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md                       | 36 ++++++++++++++++++++++++++
 Torn Training Tracker/README.md | 45 +++++++++++++++++++++++++++++++++
 2 files changed, 81 insertions(+)
 create mode 100644 README.md
 create mode 100644 Torn Training Tracker/README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..3f614f1
--- /dev/null
+++ b/README.md
@@ -0,0 +1,36 @@
+# Userscripts
+
+Collection of personal browser userscripts.
+
+## Table of Contents
+
+- [Torn Training Tracker](Torn%20Training%20Tracker/README.md)
+
+## Script Index
+
+| Script | Folder | File | Script README | Description |
+| --- | --- | --- | --- | --- |
+| Torn Training Tracker | [Torn Training Tracker](Torn%20Training%20Tracker/) | [torn-training-tracker.js](Torn%20Training%20Tracker/torn-training-tracker.js) | [README](Torn%20Training%20Tracker/README.md) | Floating tracker panel for Torn gym training progress, including target tracking and ETA estimates. |
+
+## Scripts
+
+### Torn Training Tracker
+
+- Folder: [Torn Training Tracker](Torn%20Training%20Tracker/)
+- Script: [torn-training-tracker.js](Torn%20Training%20Tracker/torn-training-tracker.js)
+- Script README: [Torn Training Tracker README](Torn%20Training%20Tracker/README.md)
+
+Floating tracker panel for Torn gym training progress, including target tracking and ETA estimates.
+
+## New Script Template
+
+When you add a new userscript, update both sections below:
+
+1. `Table of Contents` (add a link to the new script README).
+2. `Script Index` (add one table row).
+
+Copy this row template into `Script Index` and replace placeholders:
+
+```md
+| <Script Name> | [<Folder Name>](<Folder%20Name>/) | [<script-file.js>](<Folder%20Name>/<script-file.js>) | [README](<Folder%20Name>/README.md) | <Short one-line description> |
+```
diff --git a/Torn Training Tracker/README.md b/Torn Training Tracker/README.md
new file mode 100644
index 0000000..e85d8c8
--- /dev/null
+++ b/Torn Training Tracker/README.md	
@@ -0,0 +1,45 @@
+# Torn Training Tracker
+
+Userscript for Torn gym training pages that adds a floating progress panel for your active attribute.
+
+## Features
+
+- Detects current training attribute on Torn gym page.
+- Stores target values per attribute.
+- Tracks training gains over time.
+- Shows estimated trains remaining, days remaining, and ETA.
+- Keeps local history and preferences in browser storage.
+
+## Requirements
+
+- A userscript manager such as Tampermonkey or Violentmonkey.
+- Access to Torn gym pages matching:
+  - `https://www.torn.com/gym.php*`
+
+## Installation
+
+1. Open your userscript manager.
+2. Create a new script.
+3. Paste the contents of `torn-training-tracker.js`.
+4. Save and enable the script.
+
+## Usage
+
+1. Open Torn gym at `https://www.torn.com/gym.php`.
+2. Train normally.
+3. Use the floating tracker panel to set your target for the current attribute.
+4. Review projected trains, per-day pace, and ETA.
+
+## Data Storage
+
+This script stores data in `localStorage` with the following keys:
+
+- `tat.targets`
+- `tat.history`
+- `tat.prefs`
+
+Data remains local to your browser profile unless you export/sync browser storage externally.
+
+## Version
+
+Current userscript version in metadata: `0.1.0`.