tech

Your Family Health Agent: The Whole Build

The database, the skills, the Telegram bridge, the one script that keeps it alive, and a prompt you can paste into Claude Code to stand up your own this weekend.

Your Family Health Agent: The Whole Build

TL;DR

  • The build centers around a single SQLite file for local data storage, eliminating the need for servers or accounts.
  • Skills are short, plain English instructions that enable the agent to perform specific tasks like logging workouts and sleep data.
  • A Message-Content-Platform (MCP) bridge, specifically Telegram, allows the agent to interact outside the chat window via a mobile phone.
  • The system uses two interfaces: Telegram for quick data capture and a small web app for reviewing trends.
  • A crucial design decision was separating data capture (chat) from data review (web app) to reduce friction and ensure data completeness.
  • A vital maintenance script in the shell startup file prevents stale messaging-plugin processes from causing message loss.
  • The agent's role is to maintain an organized health record, supporting medical professionals rather than diagnosing or treating.
  • Two methods are provided to start: cloning a starter template from GitHub or building from scratch using a detailed prompt in Claude Code.