Chapter 9: Clocking and Time Tracking - Where Your Hours Go

Position cursor on a heading and:

• C-c C-x C-i - Clock in (start timer)
• C-c C-x C-o - Clock out (stop timer)

Org adds a CLOCK entry:

#+begin_example

#+end_example

That’s it. You just tracked 2 hours and 15 minutes on “Write documentation.”

Org maintains a clock history. Recently clocked items are accessible:

C-c C-x C-i (clock in) shows recent items:

1. Write documentation
2. Code review
3. Team meeting
4. Email processing

Type the number to clock into that task instantly. No navigating—instant time tracking.

Generate time reports:

#+BEGIN: clocktable :scope file :maxlevel 2 :block thisweek
#+END:

Put cursor on #+BEGIN: line, press C-c C-c:

#+BEGIN: clocktable :scope file :maxlevel 2 :block thisweek
| Headline               |   Time |      |
|------------------------+--------+------|
| *Total time*           | *8:30* |      |
|------------------------+--------+------|
| Write documentation    |   4:15 |      |
| Code reviews           |   2:30 |      |
| Meetings               |   1:45 |      |
#+END:

Boom. Time report. Update anytime with C-c C-c.

Remember effort estimates from Chapter 6?

#+begin_example

#+end_example

Estimated: 4 hours. Actual: 6.5 hours. Oops.

Track this systematically and your estimates improve. Data beats guesswork.

Stepped away and forgot to clock out? Org catches this:

(setq org-clock-idle-time 15)  ; Idle timeout in minutes

If Emacs detects 15 minutes of inactivity, it asks:

You have been idle for 15 minutes. Clock out from <task>?
- Keep the time (K)
- Subtract idle time (S)
- Cancel (C)

Never lose time to forgotten clock-outs again.

Multiple clocks running? (Shouldn’t happen, but life gets chaotic.)

M-x org-resolve-clocks finds overlapping or unclosed clocks and helps fix them.

Clock out when marking DONE:

(setq org-clock-out-when-done t)

Mark task complete, clock automatically stops. One less thing to remember.

Emacs crashed? Computer restarted? Don’t lose your running clock:

(setq org-clock-persist t)
(org-clock-persistence-insinuate)

Org saves clock state. Restart Emacs, resume where you left off.

Customize the running clock display:

(setq org-clock-clocked-in-display 'mode-line)  ; Show in modeline
(setq org-clock-string-limit 20)  ; Truncate long task names

Or show in frame title:

(setq org-clock-clocked-in-display 'frame-title)

Constant, gentle reminder of what you’re supposed to be doing.

By default, clock entries go in :LOGBOOK: drawer:

#+begin_example

#+end_example

Configure drawer name:

(setq org-log-into-drawer t)  ; Use LOGBOOK drawer
(setq org-clock-into-drawer "CLOCKING")  ; Custom drawer name

Keeps your headings clean. Press TAB on drawer to collapse.

Want more than basic clock tables? Combine with properties:

#+BEGIN: clocktable :scope agenda :maxlevel 2 :block thismonth :properties ("CLIENT" "PROJECT")
| Headline      | Time  | CLIENT      | PROJECT          |
|---------------+-------+-------------+------------------|
| Feature work  |  8:30 | ACME Corp   | Website Redesign |
| Bug fixes     |  4:15 | TechStart   | Mobile App       |
| Meetings      |  3:00 | Internal    | N/A              |
#+END:

Group time by client, project, or any custom property. Invoice generation in plain text.

A productive workflow:

Morning:

1. C-c a a - Open agenda
2. Navigate to first task
3. I - Clock in

Throughout day:

1. Switch tasks: C-c C-x C-i (clock into new task, auto-clocks out of current)
2. Or from agenda: navigate to task, press I

End of day:

1. C-c C-x C-o - Clock out
2. Generate daily report:

#+BEGIN: clocktable :scope agenda :block today :maxlevel 3
#+END:

Weekly review:

#+BEGIN: clocktable :scope agenda :block thisweek :maxlevel 2
#+END:

See where your week went. Adjust next week accordingly.

Log time when states change:

(setq org-clock-in-switch-to-state "IN-PROGRESS")

Clock in → task automatically switches to IN-PROGRESS. Visual indicator that you’re actively working on it.

Clock out when done:

(setq org-clock-out-when-done '("DONE" "CANCELLED"))

Mark task DONE or CANCELLED → automatic clock out.

Warn when exceeding time budgets:

#+begin_example

#+end_example

After clocking 8+ hours, Org can warn you (with appropriate configuration) that you’ve exceeded estimate.

Enable column view in agenda to see time at a glance:

(setq org-columns-default-format "%50ITEM %10CLOCKSUM %16TIMESTAMP_IA %TODO %TAGS")

In agenda, press C-c C-x C-c:

ITEM                  | CLOCKSUM | TODO | TAGS
---------------------------------------------------------
Write documentation   |     4:15 | DONE | work
Code review           |     2:30 | DONE | work:code
Team meeting          |     1:00 | DONE | meeting

Spreadsheet view of your time.

The Pomodoro Technique: work in 25-minute focused blocks. Org-Mode can help:

(setq org-clock-sound "~/sounds/bell.wav")  ; Sound when timer ends

Use org-timer:

1. C-c C-x ; - Start countdown timer (enter duration)
2. Work until sound plays
3. Take break
4. Repeat

Or use the org-pomodoro package for full Pomodoro integration (auto-breaks, statistics, etc.).

Share time reports with non-Org users:

1. Generate clock table
2. C-c C-e - Export
3. Choose format (HTML, PDF, CSV)

Your time logs become professional reports.

Or export just the table:

1. Place cursor in clock table
2. M-x org-table-export
3. Choose CSV or other format

Import into spreadsheets, billing systems, whatever you need.

Professional time tracking setup:

#+begin_example

1. Clock in and out of at least 5 different tasks
2. Let some time accumulate (work on actual tasks, or just let timers run)
3. Generate a clock table for today
4. Generate a clock table for the week
5. Try clocking from the agenda view
6. Set up clock persistence and idle time detection
7. Create a task hierarchy and see cumulative time in parent headings
8. Export a time report to HTML or CSV

What gets measured gets managed. Time tracking reveals truths:

• Tasks take longer than you think
• Interruptions destroy productivity
• Some “urgent” work isn’t actually valuable
• Your energy patterns throughout the day

Org-Mode’s time tracking is lightweight enough to actually use. No fancy apps, no cloud services, no vendor lock-in. Just plain text timestamps that aggregate into insights.

Track time for a week. The patterns that emerge will surprise you.

You’re tracking time, managing tasks, building agendas. But where do new ideas go? How do you capture thoughts without disrupting flow? Chapter 10 introduces Capture Templates—frictionless note-taking that ensures nothing gets lost.