Home Keeper

Home Keeper tracks home maintenance and chores in Home Assistant. This includes fridge and furnace filter changes, water filters, taking medicine, and anything else that recurs.

📖 Full documentation (a browsable User Guide and Developer Guide) lives at https://prestomation.github.io/ha-home-keeper/. The site is generated from docs/, so the two never drift.

What people say

It's exceptionally well thought out, fills a real gap in the Home Assistant ecosystem, and has great potential to become the go-to maintenance tracker for many users.

@psym88

So happy to finally see such a thorough solution to this problem. I hope this really takes off and becomes a core component of HA.

@peng1can

It is currently much closer to the maintenance tracker I had been looking for than anything else I tried.

@Tomblarom

Features at a glance

• Tasks support 5 recurrence types. These are floating, fixed, one-off, triggered, and sensor-based. See Concepts.
• Home Keeper provides native Home Assistant entities. A todo list and an upcoming-tasks calendar and per-device entities on a task's device page.
• Home Keeper syncs the tasks of a profile to any todo entity as they become due. A completion on that list completes the task in Home Keeper.
• The bundled dashboard card custom:home-keeper-card has a Done button and inline add and edit. It supports filtering and grouping.
• Every notes field on a task or appliance or part or completion is Markdown with a live preview.
• A task can link to a Home Assistant tag so that a scan completes it. The task can require the scan.
• The panel prints QR code labels that link to the page of an appliance or a task. See QR code labels.
• An appliance has a device page with structured metadata and optional tracked-date sensors. It has parts and wear items and spare-part inventory and documents. A CSV appliance report is available for insurance.
• Home Keeper fires a bus event for every state change and provides device triggers such as "Task became overdue" for the visual automation editor.
• Every data action is a home_keeper.* service for automations and scripts and voice.
• Home Keeper is localized in 16 languages and follows the Home Assistant language setting.
• Other integrations can contribute their own recurring tasks and stay in sync with completions.

Installation

Home Keeper is a custom integration in the HACS default list:

1. In HACS, search for Home Keeper, or open it in HACS.
2. Download Home Keeper and restart Home Assistant.
3. Add the integration from Settings → Devices & Services → Add Integration → Home Keeper.

A Home Keeper panel then appears in the sidebar. Tasks and appliances are stored locally in a single JSON document, .storage/home_keeper.

Documentation

• User Guide: every feature, with screenshots. The pages are written in docs/guide/.
• Developer Guide: how another integration contributes tasks, plus the API reference.
• Release notes.

Development

• Backend: custom_components/home_keeper/. The recurrence engine is in recurrence.py.
• Panel frontend: custom_components/home_keeper/frontend/, built with TypeScript and Rollup.
• Tests: pytest unit tests in tests/unit, Docker integration tests in tests/integration, Playwright end-to-end tests in tests/e2e, and vitest frontend tests.
• Typing: mypy custom_components/home_keeper, configured in pyproject.toml and enforced by lint.yml. Home Assistant must be installed for its types to resolve.

See AGENTS.md for workflow and RELEASE.md for releases.