Your Medical Records, But It's Just JSON and Claude Code
It turns Claude Code into a local-first personal health record by mapping every lab result and scan to structured JSON and specialist prompts.

What it does Ally-Health stores your complete medical history—biochemical tests, imaging, surgeries, medications, even radiation exposure—as flat JSON files in a strict directory tree on your local filesystem. You interact with the data entirely through Claude Code slash commands, which trigger structured extraction, querying, and analysis without touching a remote database or cloud service.
The interesting bit Rather than building a separate app, the project hijacks Claude Code’s native skill system: it defines thirteen medical specialists as markdown prompt files and orchestrates parallel “subagent” consultations to synthesize multidisciplinary opinions. It also layers on a drug-interaction engine with A/B/C/D/X severity ratings and radiation-dose tracking using body-surface-area adjustments—all driven through CLI-style slash commands.
Key highlights
- Pure local file storage: no database, no cloud uploads, completely private JSON blobs.
- MDT (Multi-Disciplinary Team) consultation via parallel specialist skills defined in markdown.
- Drug interaction detection with five-level severity classification (A through X).
- Medical report image recognition and automatic biochemical data extraction (uses GLM’s image recognition MCP).
- Runs entirely through Claude Code CLI slash commands; no separate app or programming required.
Caveats
- Requires the proprietary Claude Code CLI to function; it is essentially a prompt-and-schema layer on top of Anthropic’s tool.
- Core technical documentation and the drug-interaction contribution guidelines are primarily in Chinese, with only some docs translated.
- Image recognition relies on GLM’s
mcp__4_5v_mcp__analyze_image, not Claude’s native vision, which may add setup friction.
Verdict Worth exploring if you already live in Claude Code and want a scriptable, offline health ledger. Skip it if you need a polished standalone GUI or a clinically certified diagnostic tool—the maintainers are explicit that this is for reference only, not diagnosis.
Frequently asked
- What is huifer/WellAlly-health?
- It turns Claude Code into a local-first personal health record by mapping every lab result and scan to structured JSON and specialist prompts.
- Is WellAlly-health open source?
- Yes — huifer/WellAlly-health is open source, released under the MIT license.
- What language is WellAlly-health written in?
- huifer/WellAlly-health is primarily written in Shell.
- How popular is WellAlly-health?
- huifer/WellAlly-health has 901 stars on GitHub.
- Where can I find WellAlly-health?
- huifer/WellAlly-health is on GitHub at https://github.com/huifer/WellAlly-health.