Skip to main content

8.4 Clocking Work Time

Org mode allows you to clock the time you spend on specific tasks in a project. When you start working on an item, you can start the clock. When you stop working on that task, or when you mark the task done, the clock is stopped and the corresponding time interval is recorded. It also computes the total time spent on each subtree1 of a project. And it remembers a history or tasks recently clocked, so that you can jump quickly between a number of tasks absorbing your time.

To save the clock history across Emacs sessions, use:

(setq org-clock-persist 'history)

When you clock into a new task after resuming Emacs, the incomplete clock2 is retrieved (see Resolving idle time (1)) and you are prompted about what to do with it.

Clocking commands  Starting and stopping a clock.
The clock table  Detailed reports.
Resolving idle time  Resolving time when you’ve been idle.

  1. Clocking only works if all headings are indented with less than 30 stars. This is a hard-coded limitation of lmax in org-clock-sum.
  2. To resume the clock under the assumption that you have worked on this task while outside Emacs, use ‘(setq org-clock-persist t)’.