Org Agenda View

Customize your weekly Agenda

Some important variables:

(setq org-agenda-span 'week) ;; The no. of days to include in display
(setq org-agenda-start-on-weekday 0) ;; Week starts on Sunday
(setq org-agenda-remove-timeranges-from-blocks t)

Emacs Calendar/Diary integration

(setq org-agenda-include-diary t)
(global-set-key (kbd "C-c k") 'calendar)
(setq calendar-mark-diary-entries-flag t)

Key points about diary integration:

  • SPC, TAB, and RET can be used from the agenda buffer to jump to the diary file in order to edit existing diary entries.
  • D (org-agenda-toggle-diary) Toggles the inclusion of diary entries.
  • The i command (used in Diary to insert new entries for the current date) also works in the agenda buffer.
  • c can be used to switch back and forth between calendar and agenda.
  • It is better to use diary expressions in an Org file than in Emacs diary because Org evaluates them faster.
  • Expression entries must exists under an Org Heading and start at the left margin, as in this example:

#+beginexample

Birthdays

#+endexample

Appointment reminders

Org can be integrated with Emacs' appointment notification system to help manage and remind you of upcoming appointments.

The command org-agenda-to-appt is used to load appointments from your Org agenda files into Emacs' appointment notification facility. This helps you get reminders directly within Emacs.

Simple motions

To move up and own a line: n/p up/down

Do I use it: Yes

Visit Original File: SPC Versus TAB and RET

To view the Agenda item in its original Org file in a separate window use SPC.

(Sometimes one may need to recentre the items in the original file, in which case use L.)

Nota Bene the cursor stays in the Org Agenda window with these commands.

Use TAB to have the cursor jump to the item in its original file.

RET Leave Org Agenda and go to original file

Summary: Use "SPC" to view, TAB to edit

Do I use it? Yes

Follow Mode F

As you move point through the agenda buffer, the other window shows the corresponding location in the Org file.

Utility: View and edit multiple items quickly

Do I use it: No.

Show only the subtree of the item, not the whole file

C-c C-x b (org-agenda-tree-to-indirect-buffer)

Do I use it: No

Open another Agenda View and "append" it to the current view

A (org-agenda-append-agenda)

Interactively select another agenda view and append it to the current view, making for a single view

Do I use it? Sometimes

Delete other windows

C-x 1 or o

Change you views

v d or short d (org-agenda-day-view)

v w or short w (org-agenda-week-view)

v m (org-agenda-month-view)

With a prefix argument, jump to a specific month: C-u 8 vm

v y (org-agenda-year-view)

With a prefix argument, jump to a specific year: C-u 2024 vy

v SPC (org-agenda-reset-view)

Resets the current view to your default set by org-agenda-span.

f (org-agenda-later)

Go forward in time (prefix arguments are allowed)

b (org-agenda-earlier)

Go backward in time.

. (org-agenda-goto-today)

Go to today.

j (org-agenda-goto-date)

Prompts and allow you to jump to a specific date.

r (org-agenda-redo)
g (org-agenda-redo-all)

Recreate the agenda buffer, for example to reflect the changes after modification of the timestamps of items with S-LEFT and S-RIGHT.

A nice hidden feature

C-x C-s or short s (org-save-all-org-buffers)

Save all Org buffers

t (org-agenda-todo)
Same as C-c C-t

Change the TODO state of the item, both in the agenda and in the original Org file.

C-k (org-agenda-kill)

Delete the current agenda item.

C-c C-w (org-agenda-refile)

Refile the entry at point.

a (org-agenda-archive-default-with-confirmation)

Archive

T (org-agenda-show-tags)

Show all tags associated with the current item.

: (org-agenda-set-tags)

Set tags for the current headline.

C-c C-z or short z (org-agenda-add-note)

Add a note to the entry.

k (org-agenda-capture)

Important Command

org-capture, but uses the date at point as the default date

Bulk Actions

Use Agenda Menu