This package provides Third Time
(https://www.lesswrong.com/posts/RWu8eZqbwgB9zaerh/third-time-a-better-way-to-work)
support for Emacs.

;; Installation

This package is compatible with Emacs >= 27.1 and has no external
dependencies.  The file `third-time.el' may be placed on the
`load-path' and `require'd or auto-loaded.

;; Usage

It is recommended that you bind `third-time-start-work' to `C-x M-t
w' (or `third-time-prefix w', see below for information about the
prefix).

The command `third-time-start-work' (`C-x M-t w') starts or
restarts work.  It enables the mode if it is not enabled.

The command `third-time-start-break' (`C-x M-t b') starts a break.
If the prefix argument is passed, it will prompt for how long the
break should be, otherwise, all remaining break time is used
instead.

`third-time-long-break' (`C-x M-t l', `C-x M-t m') starts a long
(or meal) break.

`third-time-end-session' (`C-x M-t e', `C-x M-t s') ends a Third
Time session (i.e., workday).

Finally, the command `third-time-summary' (`C-x M-t S') describes
the current status, including current time in state, and
information about break times.

;; Configuration

`third-time-fraction' controls what fraction of time is used for
breaks.  It should be a positive integer.

The hooks `third-time-working-hook', `third-time-break-hook',
`third-time-long-break-hook', and `third-time-change-hook' are run
on state changes.  Those with a named state are run on change to
that state, and `third-time-change-hook' is run for all changes.
`third-time-mode-hook' is run when the mode is enabled.

;;; Logging

This library supports logging of state changes when
`third-time-log-file' is a string referring to a file.  The
variables `third-time-log-format' and `third-time-log-time-format'
control the log format, the latter of which should comply with
`format-time-strings.

`third-time-log-format' describes what a log entry looks like.  It
may contain the following formatting codes:

 - %T: the time as formatted using `third-time-log-time-format'.
 - %s: the state entered.
 - %h: the time which has been worked at `%T'.
 - %b: the time remaining for breaks.

;;; Alerting

`third-time' uses a simple minibuffer message alerting mechanism by
default.  This can be overriden with `third-time-alert-function'
which should be a function which takes one argument, a message to
alert the user with.  Other information can be `third-time-state'
for more advanced formatting.

Additionally, there's a "nag" timer which can be used to
periodically remind the user that a break has been completed.  It
is controlled with the `third-time-nag-time' which is a number of
minutes, if it is 0, no nagging will take place.

;; External Package Integration: Universal Sidecar

Users of the Universal Sidecar package
(https://git.sr.ht/~swflint/emacs-universal-sidecar) can add
`third-time-section' to `universal-sidecar-sections' to see a
summary of the current third-time status in the sidecar.

;; Bug Reports and Patches

If you find a bug or wish to submit a patch, send an email to
~swflint/public-inbox@lists.sr.ht.