Skip to content

focus

Start a timed focus session. Shows a live countdown in the terminal. Sends a desktop notification when the session ends. Optionally logs the elapsed time as a Jira worklog.

overseer focus              # 25-minute session (default)
overseer focus 45m          # 45-minute session
overseer focus 1h30m        # 90-minute session
overseer focus 90           # plain number = minutes

Duration formats accepted: 25m, 1h, 1h30m, 90 (minutes).

Jira time logging

Pass --issue to log the elapsed time to a Jira issue when the session ends. You will be prompted to confirm before the worklog is submitted.

overseer focus --issue PROJECT-123
overseer focus --issue PROJECT-123 --instance work   # pick a specific Jira instance
overseer focus 45m --issue PROJECT-123 --name "API design"
FlagDescription
--issueJira issue key to log time against
--nameLabel for the session (shown in the terminal header)
--instanceJira instance name from config (defaults to first configured)

If you stop the session early with ctrl+c, the elapsed time (minimum 1 minute) is used for the worklog prompt.