Logging completions
Home Keeper supports per-completion detail on a task. The default is a 1-tap Done. This is useful for a maintenance log of a task's cost and notes.
A completion can record:
- a free-form note
- a cost
- a photo
- who completed it, a Home Assistant
personentity
A task sets its capture mode in the On completion field:
- One-tap done is the default, with no dialog.
- Ask for details (optional) opens a dialog with the completion fields, all optional. A Skip details button completes the task without them.
- Require details opens the dialog and blocks Done until a user fills the required fields.
The dialog uploads a photo through Home Assistant's image store. The who
field lists the person entities.
A completion photo records the work on one date. For a photo that stays on the task, such as the place that needs work, use task photos. When the task has one, its cover shows at the top of the dialog.
To add a photo to a one-tap task, select the arrow beside Done, then Done with photo or note…. See after photos.
The task's history shows each completion's:
- note
- cost
- photo
- who
A past entry can be edited there without a change to the schedule. The details of
the most recent completion are also attributes of the task's next due sensor.
The home_keeper.complete_task and home_keeper.update_completion services
accept the same fields.
The dialog's Completed at field defaults to now. A user can set it to log a completion for the time the work happened. The date and time fields in the panel use the time zone of Home Assistant, not the time zone of the browser.
The next due date of a floating task is measured from the completion date, so the completion date moves the schedule. A completion that is older than the most recent one only adds an entry to the history. It does not move the due date.
Only a change to the most recent completion moves the due date. A delete or a move of an older entry keeps the due date, and also keeps a snooze or a skip. A delete of the most recent completion of a fixed task puts back the due date that the task had before that completion.
The move date button on a history row changes the date of that entry. The
edit button changes the recorded details and not the date. The
home_keeper.move_completion service performs the same move.

The capture dialog and the required gate apply only in the panel. A task completed from another surface completes immediately, with whatever metadata is passed:
- the native to-do checkbox, which passes no metadata
- the mobile app
- the device mark-done button
- a bare
home_keeper.complete_taskservice callThe dashboard card sends a user to the panel to complete a required task, instead of completing it directly. An automation can pass
note,cost,photo, andwhoto thehome_keeper.complete_taskservice.


Undo a one-tap Done
After a one-tap Done in the panel, a message names the task. Select Undo in the message to remove that completion. The task then has its previous due date again.