Review console
The health CLI is the deterministic core for reads, writes, agreement status, imports, reviews, gaps, batteries, and consults.
local-first · alias-only · own-risk
Your private, own-risk health concierge.
LLM Health helps you review labs, wearables, records, and self-reported context over time: timelines, quick reviews, diagnostic gaps, test candidates, category consults, and research queues. Local-first, alias-only, and explicit about risk.
health CLI@health/healthhealth-v2MIT
required before use
Big disclaimer: this is own-risk software, not medical care.
No medical advice: LLM Health does not diagnose, prescribe, order tests, treat disease or create a clinician relationship. It organizes records, calculations, questions and research notes. You are responsible for all decisions, delays, experiments, purchases, interventions and omissions.
Do not use it for emergencies or urgent symptoms. Do not start, stop, combine or change medications, supplements, procedures, devices or preventive protocols solely because an agent suggested or questioned something.
Every private HUB must explicitly accept the agreement once. The CLI stores only the agreement version and timestamp in agreement.json.
get running
Install, read agreement, initialize HUB.
The default path is ~/health. Use any private local or synced directory. Keep raw PDFs, Apple Health exports and clinical dumps out of Git.
brew tap nvk/tap
brew install llm-health
health agreement show
health config hub-path ~/health --init --accept-risk
health doctor
health welcomeinterfaces
Use it from a terminal, dashboard, or chat.
Dashboard
The repackaged health-v2 stack provides timelines, chart exports, wearable context, categories, and local analytics.
Chat concierge
Claude Code, Codex, OpenCode, Pi, and portable AGENTS files are supported as interfaces — not the point of the product.
what it does
Review artifacts, not magic answers.
- Ingest alias-only observations and context notes.
- Generate quick-review cards after new results.
- Open diagnostic gaps and profile-aware test candidates.
- Run broad category-agent consults like internal medicine, liver, toxins/exposures, meds/supplements and habits.
- Queue deeper research across evidence lenses while preserving disagreement.
- Ship the repackaged
health-v2analytics/dashboard stack.
what it refuses to pretend
Limits stay visible.
- Not a doctor, not a prescription engine, not an emergency service.
- No raw medical files, source paths, legal names, full DOBs or Apple device/source names in artifacts.
- Tests are
TEST_CANDIDATEcards, not orders. - Medication, supplement and protocol work is framed as review material with red flags and uncertainty.
- Research summaries can be wrong or stale; source quality and conflicts must stay visible.
common commands
Useful immediately from a terminal or agent.
health enroll --alias alex --birth-year 1983 --role adult
health data-wishlist
health dr-visit --profile alex --cadence onboarding
health ingest-note --profile alex --marker ALT --value 76 --unit U/L --category liver --flag high
health result --profile alex --marker mercury
health review --profile alex
health close-gaps --profile alex
health test-battery --profile alex --scope expanded --sources
health consult --profile alex --specialist auto
health plugin-pathsWhere is my data?
In your local HUB. The website has no backend, accounts, analytics or health-data upload.
Can I use iCloud/Dropbox?
Yes, but use aliases, keep raw dumps out of Git, and be mindful of every app/agent with filesystem access.
Why the agreement gate?
Because health outputs can affect real decisions. LLM Health forces an explicit own-risk checkpoint before profile-specific HUB work.