A local-first personal health record system for Claude Code that tracks health data, analyzes fitness and family history, and generates emergency medical summary cards.
Claude Code
$ npx -y skills add huifer/WellAlly-health --agent claude-code
Codex
$ npx skills add huifer/WellAlly-health -a codex
Cursor
$ npx skills add huifer/WellAlly-health -a cursor
Gemini CLI
$ npx skills add huifer/WellAlly-health -a gemini-cli
GitHub Copilot
$ npx skills add huifer/WellAlly-health -a github-copilot
OpenCode
$ npx skills add huifer/WellAlly-health -a opencode
Windsurf
$ npx skills add huifer/WellAlly-health -a windsurf
WellAlly Health is a local-first, AI-powered personal health record (PHR) system. It turns your medical reports, prescriptions, imaging, and daily health tracking into a private, searchable, structured knowledge base that runs entirely on your own machine — no cloud, no database server, no account required.
⚠️ Disclaimer: This project is NOT affiliated with, endorsed by, or associated with Anthropic or Claude.ai. It is an independent open-source project developed by WellAlly Tech. WellAlly Health is built on top of Claude Code's command-line tooling and uses AI image recognition (e.g. GLM
mcp__4_5v_mcp__analyze_image) for document understanding.This is not a medical device. All analysis is for personal reference only and must never replace professional medical advice.
Your health data is scattered across hospital portals, paper printouts, photos, and memory. Commercial apps ask you to upload it to their cloud. WellAlly Health takes the opposite approach:
WellAlly Health is the personal health record (PHR) / personal health information system (PHIS) for people who want AI assistance without surrendering their medical privacy.
Local-first & private
Intelligent medical document understanding
Clinical safety intelligence
Multi-disciplinary expertise
Whole-lifecycle coverage
Prerequisite: Claude Code installed and opened in this project directory.
# 1. First-time setup — set height(cm) weight(kg) birthdate
/profile set 175 70 1990-01-01
# 2. Save your first lab report from an image
/save-report /path/to/image.jpg
# 3. Record a radiation scan
/radiation add CT chest
# 4. Record a past surgery in plain language
/surgery Gallbladder removal surgery in August last year due to gallstones
# 5. Save a discharge summary from a photo
/discharge @医疗报告/出院小结.jpg
# 6. Query everything
/query all
# 7. Start a multi-disciplinary consultation
/consult
That's it — no programming, no server, no sign-up.
my-his/
├── .claude/
│ ├── commands/ # 60+ slash commands (see Command Reference)
│ │ ├── save-report.md
│ │ ├── query.md
│ │ ├── profile.md
│ │ ├── radiation.md
│ │ ├── surgery.md
│ │ ├── discharge.md
│ │ ├── medication.md
│ │ ├── interaction.md
│ │ ├── consult.md
│ │ └── specialist.md
│ └── specialists/ # 16 specialty + MDT coordinator Skills
├── data/
│ ├── profile.json # User basic profile
│ ├── radiation-records.json
│ ├── allergies.json
│ ├── interactions/ # Drug interaction database + logs
│ │ ├── interaction-db.json
│ │ └── interaction-logs/
│ ├── medications/
│ ├── 生化检查/ # Biochemical test data (YYYY-MM/...)
│ ├── 影像检查/ # Medical imaging data + image backups
│ ├── 手术记录/ # Surgery history
│ ├── 出院小结/ # Discharge summaries
│ └── index.json # Global index
└── README.md
WellAlly Health ships 62 slash commands. Highlights by domain:
Core data management
/profile · /get-profile · /query · /save-report · /report · /report-instructions · /prepare · /ai · /consult · /specialist · /allergy · /medication · /interaction · /surgery · /discharge · /radiation · /radiation-data · /symptom · /screening · /polypharmacy
Specialty analysis
/sleep · /nutrition · /diet · /fitness · /mental-health · /mood · /psych-assess · /cognitive · /tcm-constitution · /skin-health · /oral-health · /eye-health · /ent · /sexual-health · /occupational-health · /rehabilitation · /infection · /rheumatology
Child & family
/family · /child-development · /child-illness · /child-mental · /child-nutrition · /child-safety · /child-sleep · /child-vaccine
Women's & men's health
/cycle · /pregnancy · /postpartum · /menopause · /puberty · /male-menopause · /male-fertility · /prostate-health
Chronic disease & aging
/hypertension · /diabetes · /copd · /growth · /vaccine · /vaccination · /travel-health · /fall · /goal
💡 Full command specs and examples: User Guide (EN) · 用户指南（中文）
16 clinical specialty domains, coordinated by an MDT consultation orchestrator:
| # | Specialty | # | Specialty |
|---|---|---|---|
| 1 | Cardiology (心内科) | 9 | Neurology (神经内科) |
| 2 | Dermatology (皮肤科) | 10 | Oncology (肿瘤科) |
| 3 | Endocrinology (内分泌科) | 11 | Orthopedics (骨科) |
| 4 | Gastroenterology (消化科) | 12 | Pediatrics (儿科) |
| 5 | General Practice (全科) | 13 | Psychiatry (精神科) |
| 6 | Geriatrics (老年科) | 14 | Respiratory (呼吸科) |
| 7 | Gynecology (妇科) | 15 | Urology (泌尿科) |
| 8 | Hematology (血液科) | 16 | Nephrology (肾内科) |
Use /consult for a full MDT review or /specialist <domain> for a focused deep dive.
20 reusable analysis skills power the commands above:
ai-analyzer · emergency-card · family-health-analyzer · fitness-analyzer · food-database-query · goal-analyzer · health-trend-analyzer · infection-specialist · mental-health-analyzer · nutrition-analyzer · occupational-health-analyzer · oral-health-analyzer · rehabilitation-analyzer · sexual-health-analyzer · skin-health-analyzer · sleep-analyzer · tcm-constitution-analyzer · travel-health-analyzer · weightloss-analyzer · wellally-tech
🔧 Deep dive: Technical Implementation Details (中文) · Data Structure Spec
Built-in drug interaction detection covering drug–drug, drug–disease, drug–dose, and drug–food interactions, graded by a five-level severity system (A/B/C/D/X).
/interaction check # check current medications
/interaction list # list all rules
/interaction list X # show absolute-contraindication rules
📖 Drug Interaction Database Guide (中文) — medical professionals welcome to contribute.
WellAlly Health is designed for people who treat their medical history as strictly personal.
See docs/plans for design notes.
Contributions are welcome! Whether it's a new command, a specialist Skill, interaction rules, translations, or docs — we'd love your help.
Stars on GitHub
View @huifer’s profileA Claude Code plugin for scanning Claude Skills for security issues and protecting your development environment. It includes a log analyzer skill that helps locate application errors and performance bottlenecks.
@huifer@huiferReads text from scanned pages, photos and PDFs and returns it as structured Markdown or JSON, so you can pull tables, formulas and headers out of a document without retyping them. Covers many languages and works as input for AI tools.
@paddlepaddleGives your AI assistant a memory that persists across sessions, so it remembers your preferences and earlier work in this repository instead of starting fresh. Search, forget, pause and resume memories with simple commands.
@mem0aiGives AI agents a library of ready-made skills for scientific work such as metabolic flux analysis, protein experiment design, time series modeling, and analytical method validation, so research tasks need less hand-built code. It works with any agent that supports the open Agent Skills standard.
@k-dense-aiGives Claude Code skills, agents, and commands for PostHog analytics, session replay, feature flags, error tracking, and LLM observability. Includes MCP server setup and project access checks.
@posthogInstall it with the command on its page. It includes ai-analyzer, emergency-card, family-health-analyzer. Its skills do not fire on their own yet. Free and open source.
Is this plugin yours?
Claim it with GitHubSubmit a pluginPromote it