This tutorial describes some useful agenda manipulations.
The central notions are filters and limits. Filters are a way to /hide/ some agenda entries (depending on tags, categories or regular expressions). Limits are a way to limit the list of agenda entries (depending on a number of tagged entries, a number of entries with =TODO= keywords, an effort value, or a number of entries.)
Filters only act on the appearence of the agenda, limits act on the list of agenda entries itself.
Here is a list of keybinding available in the agenda buffer:
C-u C-u =
You can filter by tags, then by regexps, than by category, then by topmost parent -- in any order.
To remove all filters from the current agenda view, hit
Here is a list of options that you can set, either globally, or locally in your custom agenda:
When set to a positive integer, each option will exclude entries from other
catogories: for example,
(setq org-agenda-max-effort 100) will limit the
agenda to 100 minutes of effort and exclude any entry that as no effort
property. If you want to include entries with no effort property, use a
negative value for
One useful setup is to use
org-agenda-max-entries locally in a custom
command. For example, this custom command will display the next five
entries with a
NEXT TODO keyword.
(setq org-agenda-custom-commands '(("n" todo "NEXT" ((org-agenda-max-entries 5)))))
Once you mark one of these five entry as
DONE, rebuilding the agenda will
again the next five entries again, including the first entry that was
excluded so far.
You can also dynamically set temporary limits by pressing
org-agenda-limit-interactively RET). Those temporary limits are lost when
rebuilding the agenda.
Blocked tasks are dimmed by default in the agenda.
You can turn this feature off with this in your =.emacs.el= file:
(setq org-agenda-dim-blocked-tasks nil)
This will actually speed up the agenda generation (see ).
Then, if you want to turn this feature on temporarily for the current
agenda, just enter
M-x org-agenda-dim-blocked-tasks RET interactively.