8.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.

Motion

n

Next line (same as <up>).

p

Previous line (same as <down>).

View/GoTo org file

mouse-3

<SPC>

Display the original location of the item in another window.

L

Display original location and recenter that window.

mouse-2

mouse-1

<TAB>

Go to the original location of the item in another window. Under Emacs 22, mouse-1 will also works for this.

<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 org-agenda-start-with-follow-mode.

b

Display the entire subtree of the current item in an indirect buffer. With numerical prefix ARG, go up to this level and then take that tree. If ARG is negative, go up that many levels. With C-u prefix, do not remove the previously used indirect buffer.

l

Toggle Logbook mode. In Logbook mode, entries that where 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.

Change display

o

Delete other windows.

w

Switch to weekly view (7 days displayed together).

d

Switch to daily view (just one day displayed).

D

Toggle the inclusion of diary entries. See Weekly/Daily agenda.

g

Toggle the time grid on and off. See also the variables org-agenda-use-time-grid and org-agenda-time-grid.

r

Recreate the agenda buffer, for example to reflect the changes after modification of the time stamps 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 keyword.

s

Save all Org-mode buffers in the current Emacs session.

<right>

Display the following org-agenda-ndays days. For example, if the display covers a week, switch to the following week. With prefix arg, go forward that many times org-agenda-ndays days.

<left>

Display the previous dates.

.

Goto today.

Remote editing

0-9

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-k

Delete the current agenda item along with the entire subtree belonging to it in the original Org-mode file. If the text to be deleted remotely is longer than one line, the kill needs to be confirmed by the user. See variable org-agenda-confirm-kill.

$

Archive the subtree corresponding to the current headline.

T

Show all tags associated with the current item. Because of inheritance, this may be more than the tags listed in the line itself.

:

Set tags for the current headline.

a

Toggle the ARCHIVE tag for the current headline.

,

Set the priority for the current item. 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.

+

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.

-

S-<down>

Decrease the priority of the current item.

C-c C-s

Schedule this item

C-c C-d

Set a deadline for this item.

S-<right>

Change the time stamp associated with the current line by one day into the future. With prefix argument, change it by that many days. For example, 3 6 5 S-<right> will change it by a year. The stamp is changed in the original org file, but the change is not directly reflected in the agenda buffer. Use the r key to update the buffer.

S-<left>

Change the time stamp associated with the current line by one day into the past.

>

Change the time stamp associated with the current line to today. 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.

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. Prompts for the type of entry (day, weekly, monthly, yearly, anniversary, cyclic) and creates a new entry in the diary, just as i d etc. would do in the calendar. The date is taken from the cursor position.

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 documentation of the Emacs calendar.

C

Convert the date at cursor into many other cultural and historic calendars.

H

Show holidays for three month around the cursor date.

C-c C-x C-c

Export a single iCalendar file containing entries from all agenda files.

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.