CareSync

A local health memory agent for student caregivers. Built for Naomi — runs entirely on your machine, no cloud, no OAuth.

CareSync remembers health events across sessions, tracks medications, detects symptom patterns, and generates doctor briefings and family handoff notes.

Quick start (WSL)

cd /mnt/d/Desktop/Andrea/ggpt
chmod +x caresync

# Set up a patient
./caresync profile set --person Kamala --age 78 --conditions "high BP, type 2 diabetes"

# Log something about grandma (defaults to Kamala)
./caresync add "dizzy spell after lunch"
./caresync add "BP 138/86" --type vitals --context "morning check"

# Load demo history (resets DB)
./caresync seed

# Search patterns
./caresync search --person Kamala --query dizziness

# Generate a doctor brief
./caresync brief --person Kamala --days 14

CLI commands

Command	What it does
caresync profile set	Save patient name, age, conditions
caresync add	Quick log (defaults to Kamala)
caresync log	Log a health event (full flags)
caresync seed	Load demo timeline for Kamala
caresync search	Find symptom patterns in memory
caresync meds list/add/take/import	Track medications and stock
caresync brief	Pre-appointment summary → ./outputs/
caresync handoff	Family handoff notes → ./outputs/
caresync status	Show what's stored
caresync audit	Transparent workflow log
caresync questions	Doctor visit questions from history
caresync timeline	Visual event + lab timeline
caresync import-report	Import lab or prescription text
caresync chat	Hermes Agent TUI + skills

Hermes chat

Requires Hermes Agent installed and skills registered (scripts/setup_hermes.sh). Model/provider is configured in ~/.hermes/config.yaml.

./caresync chat
./caresync chat "has grandma had dizziness before?"

The agent runs real ./caresync commands via the terminal tool. Responses can take a while while skills and tools execute.

See SUBMISSION.md for the full hackathon writeup.

Hermes Agent integration

CareSync includes 5 Hermes skills in ./skills/health/:

• log-health-event — log symptoms and events
• symptom-search — find recurring patterns
• medication-tracker — prescriptions and pill stock
• appointment-brief — doctor visit summaries
• handoff-notes — family caregiver handoffs

Connect skills to Hermes

Add the project skills directory to your Hermes config (~/.hermes/config.yaml):

skills:
  external_dirs:
    - /mnt/d/Desktop/Andrea/ggpt/skills/health

terminal:
  cwd: /mnt/d/Desktop/Andrea/ggpt

Then restart Hermes and talk naturally — or use slash commands like /log-health-event.

Copy the system prompt from system_prompt.md into your Hermes SOUL or workspace instructions, or reference it when starting a session.

Project layout

├── caresync             # CLI launcher (run this)
├── src/caresync/        # Python package
├── skills/health/       # Hermes skills (agentskills.io format)
├── memory/              # SQLite database (auto-created)
├── outputs/             # Generated briefs and handoffs
├── data/                # Sample prescription for demos
├── system_prompt.md     # Agent personality and rules
└── demo_script.md       # Step-by-step demo flow

Demo

See demo_script.md for the full walkthrough using sample data for Kamala.

Privacy

Everything stays local. SQLite database at ./memory/caresync.db. Web search and browser are disabled in the Hermes config. No external APIs required for the CLI.