8 Agenda Views

Due to the way Org-mode works, TODO items, time-stamped items, and tagged headlines can be scattered throughout a file or even a number of files. To get an overview over open action items, or over events that are important for a particular date, this information must be collected, sorted and displayed in an organized way.

Org-mode can select items based on various criteria, and display them in a separate buffer. Six different view types are provided:

• an agenda that is like a calendar and shows information for specific dates,
• a TODO list that covers all unfinished action items,
• a tags view, showings headlines based on the tags associated with them,
• a timeline view that shows all events in a single Org-mode file, in time-sorted view,
• a stuck projects view showing projects that currently don't move along, and
• custom views that are special tag/keyword searches and combinations of different views.

The extracted information is displayed in a special agenda buffer. This buffer is read-only, but provides commands to visit the corresponding locations in the original Org-mode files, and even to edit these files remotely.

Two variables control how the agenda buffer is displayed and whether the window configuration is restored when the agenda exits: org-agenda-window-setup and org-agenda-restore-windows-after-quit.

• Agenda files: Files being searched for agenda information
• Agenda dispatcher: Keyboard access to agenda views
• Built-in agenda views: What is available out of the box?
• Presentation and sorting: How agenda items are prepared for display
• Agenda commands: Remote editing of org trees
• Custom agenda views: Defining special searches and views