The global TODO list contains all unfinished TODO items formatted and collected into a single place.
Show the global TODO list. This collects the TODO items from all
agenda files (see Agenda Views) into a single buffer. By
default, this lists items with a state the is not a DONE state.
The buffer is in
agenda-mode, so there are commands to examine
and manipulate the TODO entries directly from that buffer (see
Like the above, but allows selection of a specific TODO keyword.
You can also do this by specifying a prefix argument to
t. You are prompted for a keyword, and you may also
specify several keywords by separating them with ‘|’ as the
boolean OR operator. With a numeric prefix, the Nth keyword in
org-todo-keywords is selected.
The r key in the agenda buffer regenerates it, and you can give a prefix argument to this command to change the selected TODO keyword, for example 3 r. If you often need a search for a specific keyword, define a custom command for it (see Agenda Dispatcher).
Matching specific TODO keywords can also be done as part of a tags search (see Tag Searches).
Remote editing of TODO items means that you can change the state of a TODO entry with a single key press. The commands available in the TODO list are described in Agenda Commands.
Normally the global TODO list simply shows all headlines with TODO keywords. This list can become very long. There are two ways to keep it more compact:
org-agenda-todo-ignore-with-dateto exclude such items from the global TODO list.
org-agenda-todo-list-sublevelsto get this behavior.