symptom-timeline
Track symptoms over time and generate doctor-ready timelines. Correlates symptoms with food, weather, medication, activity, sleep, and stress. Detects patterns, flare-ups, and produces concise clinical reports.
Symptom Timeline
Track symptoms over time. Find what triggers them. Generate doctor-ready reports.
Quick Start
# Log a symptom with triggers
python3 scripts/symptom_tracker.py log \
--name headache \
--severity 7 \
--triggers "poor sleep,stress,caffeine"
# View all entries chronologically
python3 scripts/symptom_tracker.py timeline
# Find what triggers your symptoms
python3 scripts/symptom_tracker.py correlate
# Get a doctor-ready summary
python3 scripts/symptom_tracker.py summary
# Export a plain-text report for your appointment
python3 scripts/symptom_tracker.py export --output report.txt
Commands
| Command | Description |
|---|---|
log | Record a symptom (name, severity 1-10, time, notes, triggers) |
timeline | Show chronological log, optionally filtered by name or date range |
correlate | Detect trigger-symptom patterns and co-occurring symptoms |
summary | Generate a doctor-ready report with trends and triggers |
flare-up | Detect worsening patterns (consecutive high severity, sudden jumps) |
heatmap | ASCII severity heatmap over days/weeks |
export | Export a plain-text report for a doctor visit |
Trigger Categories
The script auto-categorizes triggers into:
- food — meals, dairy, gluten, caffeine, alcohol, etc.
- stress — anxiety, work pressure, deadlines
- weather — humidity, barometric pressure, temperature
- medication — drugs, doses, missed medications
- sleep — insomnia, poor sleep, fatigue
- activity — exercise, prolonged sitting/standing
You can also use explicit prefixes: food:dairy, weather:high humidity.
Data Storage
All data is stored in symptom_db.json (in the skill directory by default).
Use --db /path/to/file.json to specify a custom location.
References
- Symptom Tracking Guide — what to track for common conditions
- Doctor Visit Prep — how to present symptoms effectively
- Downloads
- Security audit
- Pass
- Last updated
- 3mo ago
- Current version
- v0.1.0
- License
- MIT-0
