10.2 The agenda dispatcher
The views are created through a dispatcher, which should be bound to a
global key—for example C-c a (see Activation). In the
following we will assume that C-c a is indeed how the dispatcher
is accessed and list keyboard access to commands accordingly. After
pressing C-c a, an additional letter is required to execute a
command. The dispatcher offers the following default commands:
- Create the calendar-like agenda (see Weekly/daily agenda).
- t / T
- Create a list of all TODO items (see Global TODO list).
- m / M
- Create a list of headlines matching a TAGS expression (see Matching tags and properties).
- Create a list of entries selected by a boolean expression of keywords
and/or regular expressions that must or must not occur in the entry.
- Search for a regular expression in all agenda files and additionally in
the files listed in
uses the Emacs command
multi-occur. A prefix argument can be
used to specify the number of context lines for each match, default is
- # / !
- Create a list of stuck projects (see Stuck projects).
- Restrict an agenda command to the current buffer1. After pressing <, you still need to press the character
selecting the command.
- < <
- If there is an active region, restrict the following agenda command to
the region. Otherwise, restrict it to the current subtree2. After pressing < <, you still need to press the
character selecting the command.
- Toggle sticky agenda views. By default, Org maintains only a single agenda
buffer and rebuilds it each time you change the view, to make sure everything
is always up to date. If you often switch between agenda views and the build
time bothers you, you can turn on sticky agenda buffers or make this the
default by customizing the variable
org-agenda-sticky. With sticky
agendas, the agenda dispatcher will not recreate agenda views from scratch,
it will only switch to the selected one, and you need to update the agenda by
hand with r or g when needed. You can toggle sticky agenda view
any time with
You can also define custom commands that will be accessible through the
dispatcher, just like the default commands. This includes the
possibility to create extended agenda buffers that contain several
blocks together, for example the weekly agenda, the global TODO list and
a number of special tags matches. See Custom agenda views.