10.5 Commands in the agenda buffer
Entries in the agenda buffer are linked back to the Org file or diary
file where they originate. You are not allowed to edit the agenda
buffer itself, but commands are provided to show and jump to the
original entry location, and to edit the Org files “remotely” from
the agenda buffer. In this way, all information is stored only once,
removing the risk that your agenda and note files may diverge.
Some commands can be executed with mouse clicks on agenda lines. For
the other commands, the cursor needs to be in the desired line.
- n (
Next line (same as <DOWN> and C-n).
- p (
Previous line (same as <UP> and C-p).
- N (
Next item: same as next line, but only consider items.
- P (
Previous item: same as previous line, but only consider items.
- View/Go to Org file
- <SPC> or mouse-3 (
Display the original location of the item in another window. With prefix
arg, make sure that drawers stay folded.
- L (
Display original location and recenter that window.
- <TAB> or mouse-2 (
Go to the original location of the item in another window.
- <RET> (
Go to the original location of the item and delete other windows.
- F (
Toggle Follow mode. In Follow mode, as you move the cursor through
the agenda buffer, the other window always shows the corresponding
location in the Org file. The initial setting for this mode in new
agenda buffers can be set with the variable
- C-c C-x b (
Display the entire subtree of the current item in an indirect buffer. With a
numeric prefix argument N, go up to level N and then take that tree. If N is
negative, go up that many levels. With a C-u prefix, do not remove the
previously used indirect buffer.
- C-c C-o (
Follow a link in the entry. This will offer a selection of any links in the
text belonging to the referenced Org node. If there is only one link, it
will be followed without a selection prompt.
- Change display
- Interactively select another agenda view and append it to the current view.
- Delete other windows.
- v d or short d (
- v w or short w (
- v t (
- v m (
- v y (
- v <SPC> (
Switch to day/week/month/year view. When switching to day or week view, this
setting becomes the default for subsequent agenda refreshes. Since month and
year views are slow to create, they do not become the default. A numeric
prefix argument may be used to jump directly to a specific day of the year,
ISO week, month, or year, respectively. For example, 32 d jumps to
February 1st, 9 w to ISO week number 9. When setting day, week, or
month view, a year may be encoded in the prefix argument as well. For
example, 200712 w will jump to week 12 in 2007. If such a year
specification has only one or two digits, it will be mapped to the interval
1938–2037. v <SPC> will reset to what is set in
- f (
Go forward in time to display the following
For example, if the display covers a week, switch to the following week.
With prefix arg, go forward that many times
- b (
Go backward in time to display earlier dates.
- . (
Go to today.
- j (
Prompt for a date and go there.
- J (
Go to the currently clocked-in task in the agenda buffer.
- D (
Toggle the inclusion of diary entries. See Weekly/daily agenda.
- v l or short l (
Toggle Logbook mode. In Logbook mode, entries that were marked DONE while
logging was on (variable
org-log-done) are shown in the agenda, as are
entries that have been clocked on that day. You can configure the entry
types that should be included in log mode using the variable
org-agenda-log-mode-items. When called with a C-u prefix, show
all possible logbook entries, including state changes. When called with two
prefix arguments C-u C-u, show only logging information, nothing else.
v L is equivalent to C-u v l.
- v [ or short [ (
Include inactive timestamps into the current view. Only for weekly/daily
- v a (
- v A (
Toggle Archives mode. In Archives mode, trees that are marked
ARCHIVED are also scanned when producing the agenda. When you use the
capital A, even all archive files are included. To exit archives mode,
press v a again.
- v R or short R (
Toggle Clockreport mode. In Clockreport mode, the daily/weekly agenda will
always show a table with the clocked times for the time span and file scope
covered by the current agenda view. The initial setting for this mode in new
agenda buffers can be set with the variable
org-agenda-start-with-clockreport-mode. By using a prefix argument
when toggling this mode (i.e., C-u R), the clock table will not show
contributions from entries that are hidden by agenda filtering1. See
also the variable
- v c
Show overlapping clock entries, clocking gaps, and other clocking problems in
the current agenda range. You can then visit clocking lines and fix them
manually. See the variable
information on how to customize the definition of what constituted a clocking
problem. To return to normal agenda display, press l to exit Logbook
- v E or short E (
Toggle entry text mode. In entry text mode, a number of lines from the Org
outline node referenced by an agenda line will be displayed below the line.
The maximum number of lines is given by the variable
org-agenda-entry-text-maxlines. Calling this command with a numeric
prefix argument will temporarily modify that number to the prefix value.
- G (
Toggle the time grid on and off. See also the variables
- r (
Recreate the agenda buffer, for example to reflect the changes after
modification of the timestamps of items with S-<LEFT> and
S-<RIGHT>. When the buffer is the global TODO list, a prefix
argument is interpreted to create a selective list for a specific TODO
- g (
Same as r.
- C-x C-s or short s (
Save all Org buffers in the current Emacs session, and also the locations of
- C-c C-x C-c (
Invoke column view (see Column view) in the agenda buffer. The column
view format is taken from the entry at point, or (if there is no entry at
point), from the first entry in the agenda view. So whatever the format for
that entry would be in the original buffer (taken from a property, from a
#+COLUMNS line, or from the default variable
org-columns-default-format), will be used in the agenda.
- C-c C-x > (
Remove the restriction lock on the agenda, if it is currently restricted to a
file or subtree (see Agenda files).
- Secondary filtering and query editing
For a detailed description of these commands, see Filtering/limiting agenda items.
- / (
Filter the agenda view with respect to a tag and/or effort estimates.
- < (
Filter the current agenda view with respect to the category of the item at
- ^ (
Filter the current agenda view and only display the siblings and the parent
headline of the one at point.
- = (
Filter the agenda view by a regular expression.
- _ (
Filter the agenda view with respect to effort estimates.
- | (
Remove all filters in the current agenda view.
- Remote editing
- Digit argument.
- C-_ (
Undo a change due to a remote editing command. The change is undone
both in the agenda buffer and in the remote buffer.
- t (
Change the TODO state of the item, both in the agenda and in the
original org file.
- C-S-<RIGHT> (
- C-S-<LEFT> (
Switch to the next/previous set of TODO keywords.
- C-k (
Delete the current agenda item along with the entire subtree belonging
to it in the original Org file. If the text to be deleted remotely
is longer than one line, the kill needs to be confirmed by the user. See
- C-c C-w (
Refile the entry at point.
- C-c C-x C-a or short a (
Archive the subtree corresponding to the entry at point using the default
archiving command set in
org-archive-default-command. When using the
a key, confirmation will be required.
- C-c C-x a (
Toggle the ARCHIVE tag for the current headline.
- C-c C-x A (
Move the subtree corresponding to the current entry to its archive
- C-c C-x C-s or short $ (
Archive the subtree corresponding to the current headline. This means the
entry will be moved to the configured archive location, most likely a
- T (
Show all tags associated with the current item. This is useful if you have
org-agenda-show-inherited-tags, but still want to see all
tags of a headline occasionally.
- : (
Set tags for the current headline. If there is an active region in the
agenda, change a tag for all headings in the region.
- Set the priority for the current item (org-agenda-priority).
Org mode prompts for the priority character. If you reply with <SPC>,
the priority cookie is removed from the entry.
- P (
Display weighted priority of current item.
- + or S-<UP> (
Increase the priority of the current item. The priority is changed in
the original buffer, but the agenda is not resorted. Use the r
key for this.
- - or S-<DOWN> (
Decrease the priority of the current item.
- z or C-c C-z (
Add a note to the entry. This note will be recorded, and then filed to the
same location where state change notes are put. Depending on
org-log-into-drawer, this may be inside a drawer.
- C-c C-a (
Dispatcher for all command related to attachments.
- C-c C-s (
Schedule this item. With prefix arg remove the scheduling timestamp
- C-c C-d (
Set a deadline for this item. With prefix arg remove the deadline.
- S-<RIGHT> (
Change the timestamp associated with the current line by one day into the
future. If the date is in the past, the first call to this command will move
it to today.
With a numeric prefix argument, change it by that many days. For example,
3 6 5 S-<RIGHT> will change it by a year. With a C-u prefix,
change the time by one hour. If you immediately repeat the command, it will
continue to change hours even without the prefix arg. With a double C-u
C-u prefix, do the same for changing minutes.
The stamp is changed in the original Org file, but the change is not directly
reflected in the agenda buffer. Use r or g to update the buffer.
- S-<LEFT> (
Change the timestamp associated with the current line by one day
into the past.
- > (
Change the timestamp associated with the current line. The key > has
been chosen, because it is the same as S-. on my keyboard.
- I (
Start the clock on the current item. If a clock is running already, it
is stopped first.
- O (
Stop the previously started clock.
- X (
Cancel the currently running clock.
- J (
Jump to the running clock in another window.
- k (
org-capture, but use the date at point as the default date for
the capture template. See
org-capture-use-agenda-date to make this
the default behavior of
- Dragging agenda lines forward/backward
- M-<up> (
Drag the line at point backward one line2. With a numeric prefix argument, drag backward by that
- M-<down> (
Drag the line at point forward one line. With a numeric prefix argument,
drag forward by that many lines.
- Bulk remote editing selected entries
- m (
Mark the entry at point for bulk action. With numeric prefix argument, mark
that many successive entries.
- * (
Mark all visible agenda entries for bulk action.
- u (
Unmark entry at point for bulk action.
- U (
Unmark all marked entries for bulk action.
- M-m (
Toggle mark of the entry at point for bulk action.
- M-* (
Toggle marks of all visible entries for bulk action.
- % (
Mark entries matching a regular expression for bulk action.
- B (
Bulk action: act on all marked entries in the agenda. This will prompt for
another key to select the action to be applied. The prefix arg to B
will be passed through to the s and d commands, to bulk-remove
these special timestamps. By default, marks are removed after the bulk. If
you want them to persist, set
or hit p at the prompt.
- Toggle persistent marks.
- Archive all selected entries.
- Archive entries by moving them to their respective archive siblings.
- Change TODO state. This prompts for a single TODO keyword and changes the
state of all selected entries, bypassing blocking and suppressing logging
notes (but not timestamps).
- Add a tag to all selected entries.
- Remove a tag from all selected entries.
- Schedule all items to a new date. To shift existing schedule dates by a
fixed number of days, use something starting with double plus at the prompt,
for example ‘++8d’ or ‘++2w’.
- Set deadline to a specific date.
- Prompt for a single refile target and move all entries. The entries will no
longer be in the agenda; refresh (g) to bring them back.
- Reschedule randomly into the coming N days. N will be prompted for. With
prefix arg (C-u B S), scatter only across weekdays.
- Apply a function3 to marked entries. For
example, the function below sets the CATEGORY property of the entries to web.
(defun set-category ()
(let* ((marker (or (org-get-at-bol 'org-hd-marker)
(buffer (marker-buffer marker)))
(org-set-property "CATEGORY" "web"))))))
- Calendar commands
- c (
Open the Emacs calendar and move to the date at the agenda cursor.
- c (
When in the calendar, compute and show the Org mode agenda for the
date at the cursor.
- i (
Insert a new entry into the diary, using the date at the cursor and (for
block entries) the date at the mark. This will add to the Emacs diary
file4, in a way similar to the i
command in the calendar. The diary file will pop up in another window, where
you can add the entry.
If you configure
org-agenda-diary-file to point to an Org mode file,
Org will create entries (in Org mode syntax) in that file instead. Most
entries will be stored in a date-based outline tree that will later make it
easy to archive appointments from previous months/years. The tree will be
built under an entry with a
DATE_TREE property, or else with years as
top-level entries. Emacs will prompt you for the entry text—if you specify
it, the entry will be created in
org-agenda-diary-file without further
interaction. If you directly press <RET> at the prompt without typing
text, the target file will be shown in another window for you to finish the
entry there. See also the k r command.
- M (
Show the phases of the moon for the three months around current date.
- S (
Show sunrise and sunset times. The geographical location must be set
with calendar variables, see the documentation for the Emacs calendar.
- C (
Convert the date at cursor into many other cultural and historic
- H (
Show holidays for three months around the cursor date.
- M-x org-icalendar-combine-agenda-files <RET>
- Export a single iCalendar file containing entries from all agenda files.
This is a globally available command, and also available in the agenda menu.
- Exporting to a file
- C-x C-w (
Write the agenda view to a file. Depending on the extension of the selected
file name, the view will be exported as HTML (.html or .htm),
Postscript (.ps), PDF (.pdf), Org (.org) and plain text
(any other extension). When exporting to Org, only the body of original
headlines are exported, not subtrees or inherited tags. When called with a
C-u prefix argument, immediately open the newly created file. Use the
org-agenda-exporter-settings to set options for
ps-print and for htmlize to be used during export.
- Quit and Exit
- q (
Quit agenda, remove the agenda buffer.
- x (
Exit agenda, remove the agenda buffer and all buffers loaded by Emacs
for the compilation of the agenda. Buffers created by the user to
visit Org files will not be removed.