Table of Contents

Previous: Agenda commands, Up: Agenda Views

10.5 Custom agenda views

The main application of custom searches is the definition of keyboard shortcuts for frequently used searches, either creating an agenda buffer, or a sparse tree (the latter covering of course only the current buffer). Custom commands are configured in the variable org-agenda-custom-commands. You can customize this variable, for example by pressing C-c a C. You can also directly set it with Emacs Lisp in .emacs. The following example contains all valid search types:

     (setq org-agenda-custom-commands
           '(("w" todo "WAITING")
             ("u" tags "+boss-urgent")
             ("v" tags-todo "+boss-urgent")))

The initial string in each entry defines the keys you have to press after the dispatcher command C-c a in order to access the command. Usually this will be just a single character. The second parameter is the search type, followed by the string or regular expression to be used for the matching. The example above will therefore define:

C-c a w
as a global search for TODO entries with ‘WAITING’ as the TODO keyword
C-c a u
as a global tags search for headlines marked ‘:boss:’ but not ‘:urgent:
C-c a v
as the same search as C-c a u, but limiting the search to headlines that are also TODO items

Further reading
Chapter 10 of the manual
Mat Lundin's tutorial about custom agenda commands
John Wiegley's setup