Timer

The timer surface has three layers. The header pill lives in the top bar of every page once a timer is running. The composer page at /time/timer is where you start, edit, and review entries in three views (Calendar / List / Timesheet). And embedded <TimeOnRecord> widgets put a Start-timer button on every CRM contact, deal, support ticket, project task, and recruiting candidate.

The composer

The composer bar pinned to the top of /time/timer is the single most important element on the page. Designed to feel like Toggl's "What are you working on?" prompt:

Inline keyboard tokens

While typing the description, you can reference entities inline:

working on @deal:Acme renewal #bug /project:Q1

On blur, @deal:Acme → resolves to the matching CRM deal and pre-fills the entity chip. #bug becomes a tag. /project:Q1 sets the project chip. The text in the description is left clean (tokens stripped) so the entry reads naturally.

The three views

A segmented control between the composer and the content switches views. View + week are mirrored to the URL (?view=calendar|list|timesheet&week=YYYY-MM-DD) so refreshes and shared links round-trip cleanly.

Calendar view

Week grid, hour rows running 00:00–23:00, day columns. Time entries with started_at / ended_at render as colored blocks anchored at the right time. Drag an empty area to create a new entry. Click a block to open a side drawer for edit / duplicate / delete.

Calendar events from your connected Google / M365 calendars (see Calendar Import) appear as ghost blocks with a + convert CTA on hover.

List view

Day-grouped chronological list. Identical entries (same description + entity + billable + project) get grouped under a count badge with aggregate hours; clicking expands. Multi-select rows with checkboxes for bulk-edit (project, billable, tags) or bulk-delete.

Timesheet view

Pivot grid — rows are projects/entities, columns are the 7 days of the week, cells are decimal hours. Today's column gets a faint primary tint. Each cell with hours shows a small green dot if any underlying entry is billable. Click a cell to see / edit the entries it represents.

Sticky Daily total row at the bottom + Total column on the right. Grand total in the bottom-right corner.

Header pill — the always-visible running indicator

Once any timer starts, a compact pill appears in the top bar of every page:

• Pulsing primary dot · entity icon · description (truncated) · live HH:MM:SS clock · circular destructive Stop button.
• Click the pill body → navigates to /time/timer.
• Click Stop → stops the timer in place, no navigation.

Hidden when no timer is running. Fully replaces the older floating bottom-right widget for the global case (the floating widget still appears in inline embeds on detail pages because those don't have the global header).

Browser tab title

When a timer runs, the browser tab title becomes:

0:18:42 · Working on Acme renewal

Ticks once per second. Restored to the page's normal title when the timer stops. Lets you spot a forgotten timer from any tab.

Pomodoro mode

Click the Timer icon in the composer to toggle Pomodoro:

• Focus → Short break → Focus → Short break → Focus → Short break → Focus → Long break — every 4th focus gets a long break.
• Default durations: 25 / 5 / 15 minutes (configurable in Settings).
• The composer's elapsed clock is replaced by the Pomodoro phase + countdown ("Focus 18:42").
• On phase complete, plays a soft tone and (with permission) sends a browser notification.
• Inline pause and skip buttons appear next to the countdown.
• Independent of the time-tracking timer — you can use Pomodoro without any timer running.

Idle detection

Whenever a timer is running, the app watches for activity (mouse, keyboard, focus). If you've been idle longer than time_tracking_settings.idle_minutes (default 10), a dialog opens:

You've been away — no activity for 12:34. What would you like to do with that time?

• Keep idle time — dismiss, the running entry continues
• Discard idle time — stop the timer immediately so the recorded hours don't span the idle stretch
• Split into two entries (coming soon — currently treated like Keep)

The threshold is configurable per workspace.

Cmd+K — "Log time…"

Press Cmd+K (or Ctrl+K on Windows/Linux) anywhere in the app. Search "Log time" or scroll to the command. Opens the time-entry quick-add sheet, pre-seeded with the focused entity (e.g. on a task page, the task is already selected).

The conversational AI also supports it: "log 45 min on Acme renewal yesterday afternoon" → AI parses → confirmation card → confirm → entry created.

Switching entities mid-day

You can only have one timer running at a time per user. This is enforced at the database level (a partial unique index), so even if you start one on your desktop and another on your phone, the older one stops automatically.

To switch:

1. Open the composer page (/time/timer).
2. Stop the current timer, change description / entity, hit Start again. Or
3. Click the running pill in the header → routes to the composer → change context → stop & start.

What gets saved on stop

A row is created in the time_entries table with:

• started_at and ended_at — for the audit / "actual session window"
• hours — computed from start/end with rounding applied
• entity_type + entity_id — what you were working on
• project_id — denormalized from the entity (auto for tasks → project)
• hourly_rate, cost_rate, currency — snapshotted from the rate resolver at write-time
• billable — whether this is billable work
• source — 'timer' (vs 'manual', 'imported', 'api')
• status — 'draft' until you submit your timesheet

Auto-stop for runaway timers (Pro)

If you forget to stop a timer overnight, the runaway-timer cron catches it. Default threshold: 12 hours (runaway_timer_hours in settings). Two behaviors:

• Notify only (free): you get an in-app notification that a timer has been running long. The timer keeps going.
• Auto-stop (Pro — runaway_timer_hours_auto_stop = true): the cron stops the timer at the threshold and tags the entry for review.

Next steps

• Calendar Import — turn meetings into time entries with one click
• Goals — set hour targets, see progress in the composer
• Weekly Timesheet — review and submit a week's worth of entries
• Settings — week start, rounding, idle minutes, Pomodoro durations