1. Docs
2. /
3. Tool reference
4. /
5. Focus Sessions

Focus Sessions

The Timer surface as verbs: start a Timer, Stopwatch, or Pomodoro, pause and resume it, re-time it without restarting, rename it, stop it (logged) or cancel it (not logged), and read both what is running and the Log of what was.

13 verbs in this family.

• adjustTimer write Re-time a running Timer or Pomodoro without restarting it: the focus already banked is kept.
• cancelSession write Abandon the running Focus Session WITHOUT logging it: the session ends, no entry reaches the Log and no completion notification fires.
• deleteSessionLogEntry writedestructive DESTRUCTIVE: permanently deletes a completed Focus Session from the Log.
• pauseSession write Pause the running Focus Session: the clock stops and the paused time is not counted as focus.
• readSession read Read the Focus Session running right now: its mode (Timer, Stopwatch or Pomodoro), label, state (active, paused, on a break), time elapsed, and time remaining: plus any other sessions being carried.
• readSessionLog read Read recent entries from the Focus Session Log: completed sessions with what they were called, how long was focused, and when.
• renameSession write Rename the Focus Session that is currently running: relabels the live session, not a past one.
• renameSessionLogEntry write Rename a completed Focus Session in the Log: corrects what a past session was called, without touching its recorded time.
• resumeSession write Resume a paused Focus Session: picks up from where it was paused, keeping the focus already banked.
• startPomodoro write Start a Pomodoro Focus Session: repeating focus intervals with breaks between them, unlike a plain Timer which runs once.
• startStopwatch write Start a Stopwatch Focus Session: counts UP with no set end, for when the work's length isn't known in advance.
• startTimer write Start a countdown Focus Session: a Timer that runs for a set duration and then completes.
• stopSession write Stop the running Focus Session and LOG it: the session completes, the focused time is recorded in the Log, and the completion notification fires, exactly as pressing Stop in the app does.