Skip to content

Time Tracking

Time tracking in Kaisho works three ways: start/stop timers, retroactive booking, and quick booking. All methods produce the same clock entries.

Time Tracking

Starting a Timer

The clock widget is always visible on the right side of the screen. Select a customer, optionally type a description, and press Start.

The elapsed time counts up in real time. The header bar and the menu bar tray (desktop app) also show the active timer.

kai clock start "Acme Corp" "Working on feature X"

Check what's running:

kai clock status

Press Cmd+J in the UI and type:

clock start Acme Corp Working on feature X

Stopping a Timer

Press Stop in the clock widget or the active timer banner.

kai clock stop

Set description or notes before stopping:

kai clock stop --desc "Finished the auth module"
kai clock stop --notes "Needs code review"
kai clock stop --customer "Beta Inc"  # reassign

Booking Retroactively

Forgot to start the timer? Book time after the fact:

kai clock book 2h "Acme Corp" "Morning standup + planning"
kai clock book 30min "Beta Inc" "Quick bug fix"

In the UI, use the Quick Book form in the clock widget. Enter duration, customer, and description.

Editing Entries

Every clock entry is editable. In the Clocks view:

  • Click any cell to edit it inline
  • Change customer, description, hours, date, contract, or notes
  • Toggle the invoiced flag
  • Link entries to tasks

The table supports column filtering (including regex), sorting, and resizing.

Viewing Entries

Filter entries by period:

Filter CLI UI
Today kai clock list --today Period toggle: Today
This week kai clock list --week Period toggle: Week
This month kai clock list --month Period toggle: Month
Custom range kai clock list --from 2026-04-01 --to 2026-04-15 Date picker
By customer kai clock list --customer "Acme Corp" Column filter

Summary

See total hours per customer:

kai clock summary          # this month
kai clock summary --week   # this week

The dashboard budget bars show the same data visually.

Invoicing

Mark entries as invoiced when you bill a customer:

In the Clocks view, filter by customer, select the entries, and click Mark Invoiced. Or use the invoice preview in the customer's contract view.

kai clock batch-invoice "Acme Corp"
kai clock batch-invoice "Acme Corp" --contract "Q2 2026"

Toggle the Hide Invoiced switch in the clocks toolbar to focus on unbilled time.

Export

Export filtered entries as CSV or Excel from the Clocks view toolbar. The export includes all visible columns.

The desktop app shows a timer icon in the menu bar (macOS) or system tray (Windows/Linux):

  • Left-click opens a popover with the active timer, quick-start buttons, and recent entries
  • Right-click shows a context menu with start/stop actions
  • The icon changes color based on timer state: idle, active, or running long

Global shortcuts:

  • Cmd+Shift+T -- Toggle tray popover
  • Cmd+Shift+S -- Start/stop timer

iCalendar Feed

Clock entries are available as an iCal feed at:

http://localhost:8765/api/clocks/calendar.ics

Add this URL to your calendar app to see time entries alongside your schedule. The feed updates in real time.