Focus timer

Name: Focus timer
Author: dip497

Widget Productivity @dip497 0 installs

Work for a set time, then take a break, round after round; an agent can start one for you.

hive plugins install @dip497/focus-timer

Run it in a terminal, or find it in Hivemind under Settings ▸ Plugins.

Overview Install Versions

Focus timer

A focus timer for you while your agents work: 25 minutes of focus, then a break, round after round, with a notification at each change. The timer is the widget's state, so everyone in the workspace sees the same one and it survives a restart. An agent can start one for you.

hive plugins install @dip497/focus-timer   # then add it from the toolbar's Add menu
hive ctl plugin open @dip497/focus-timer        # or let an agent place it
hive ctl plugin call @dip497/focus-timer start '{"minutes":50}'
hive ctl plugin call @dip497/focus-timer status
hive ctl plugin call @dip497/focus-timer pause

It asks for no permissions.

Options (the gear on the widget): focus and break: their lengths in minutes.

How it was made

Built by a coding agent (Claude) from the widget contract: hive plugins new widget's brief, hive.d.ts and the Widgets guide, then checked in the app over the demo workspace. Its behaviour test is tests/widgets.test.ts in this repository, which runs widget.js with the same worker prelude the app uses.

Files

From dip497/hivemind-plugins at c1a1f28. Hivemind checks each file's checksum as it downloads, and stops if one changed.

icon.svg58dc03bda0a5
README.md896ee5ed711f
widget.js98c42f122437
widget.json49ec3f11d633

widget.json

{
  "id": "@dip497/focus-timer",
  "name": "Focus timer",
  "version": "1.0.0",
  "description": "Work for a set time, then take a break, round after round; an agent can start one for you.",
  "category": "productivity",
  "icon": "icon.svg",
  "size": { "w": 260, "h": 150 },
  "options": [
    { "id": "focus", "label": "Minutes of focus", "type": "number", "min": 1, "max": 120, "default": 25 },
    { "id": "break", "label": "Minutes of break", "type": "number", "min": 1, "max": 60, "default": 5 }
  ],
  "commands": [
    { "name": "start", "description": "Start or resume the timer; minutes sets this round's length.", "args": "{ \"minutes\"?: number }" },
    { "name": "pause", "description": "Pause the timer." },
    { "name": "status", "description": "Focus or break, running or not, the time left and the rounds done." }
  ]
}

Version	Commit	Listed
1.0.0	`c1a1f28`	October 20, 2026

HiveHub keeps the version listed last. The ones before it are in the repository's history.

Something wrong with it? Report it.