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 subtree71 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)
(org-clock-persistence-insinuate)

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


Footnotes

(71)

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.

(72)

To resume the clock under the assumption that you have worked on this task while outside Emacs, use ‘(setq org-clock-persist t)’.