The agenda

The agenda collects the dated entries and the TODO items of all your agenda_files into one read-only buffer: a calendar of days, a TODO list, the result of a tag or text search. From that buffer you can act on the entries (change their state, reschedule them, clock in, refile …) without visiting the files. This file teaches every agenda view and key, with a data set whose agenda output is written out below, line by line, so you can compare.

• The file starts folded (#+STARTUP: overview). Put the cursor on a heading and press <Tab> to open it; <S-Tab> cycles the whole buffer.
• Keys assume the default prefix: <prefix> means <leader>o (Space o with the bundled init file). Emacs keys such as C-c a work too (:h org-emacs-keys).
• g? lists the keys of the current buffer: in an org buffer the org keys, in the agenda the agenda keys.
• Nothing breaks if you make a mess: u in this buffer undoes, and git checkout examples/09-agenda.org restores the file. Edits made from the agenda change this buffer but do not save it; quit with :qa! to throw them away.
• Lines starting with Try: are exercises. Expect: says what you should see, for the file as it is in git: after changing entries, the agenda changes too. git checkout examples/09-agenda.org (then :e!) resets it.
• Lines starting with =# = are Org comments that annotate the examples.

Start Neovim from the repository root with the bundled init file:

nvim -u examples/minimal_init.lua examples/09-agenda.org

examples/minimal_init.lua sets agenda_files to every .org file of examples/ (plus the capture scratch directory), defines the custom agenda commands w and u, turns on enforce_todo_dependencies, and says that a project is a heading tagged :project: (agenda.stuck_projects).

Because all the example files are agenda files, a plain agenda mixes the entries of every file. Restrict the agenda to this file (next section): press <prefix>a, then <, then the view key. The expected output in this file assumes you did.

Today, in this file, is Monday 2026-09-28. On another day the "In N d." counts and the "today" lines differ: the time grid, the Sched. and In N d. lines and the habit graph are always drawn for the real today.

Everything below this heading is the data set of the date agenda. Each group explains what the agenda makes of its entries. The week of Monday 2026-09-28:

TODO entries without a date never show in the date agenda, only in the TODO list and in matches. Their priorities, efforts and the CLIENT property are used by the sorting, filter and match examples.

This is the agenda of this file (<prefix>a < a=) on Monday 2026-09-28, in an 80-column window. A line starts with the category (agenda:), then the time or the leader (Scheduled:, In 4 d.: …), then the headline and its tags. The tags are aligned to the right edge of the window, so they move with your window width. The ┄┄┄┄┄ lines are the time grid, drawn in today's agenda only; the ← now line sits at the current time (written HH:MM here). Within a day, timed entries come first, then the others by urgency.

Week-agenda (W40):
Monday     28 September 2026 W40
               8:00 ┄┄┄┄┄ ┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄
  agenda:      9:30 ┄┄┄┄┄ Scheduled:  TODO Team standup                  :work:
              10:00 ┄┄┄┄┄ ┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄
              12:00 ┄┄┄┄┄ ┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄
              14:00 ┄┄┄┄┄ ┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄
              HH:MM ┄┄┄┄┄ ← now ───────────────────────────────────────────────
              16:00 ┄┄┄┄┄ ┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄
  agenda:     18:00 ┄┄┄┄┄ Gym
              18:00 ┄┄┄┄┄ ┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄
              20:00 ┄┄┄┄┄ ┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄
  agenda:     Sched. 4x:  TODO Clean the gutters                         :home:
  agenda:     Sched. 3x:  TODO Return the library books                :errand:
  agenda:     Scheduled:  TODO Call the plumber                          :home:
  agenda:     Scheduled:  DONE Pay the electricity bill                  :home:
  agenda:     Scheduled:  TODO Tidy the desk                             :home:
  agenda:     Scheduled:  TODO Sort the photos                           :home:
  agenda:     Scheduled:  TODO Back up the laptop                        :work:
  agenda:      4 d. ago:  TODO Send the birthday card                  :errand:
  agenda:     Water the plants                                           :home:
  agenda:     In   3 d.:  TODO Pay the rent                              :home:
  agenda:     In   4 d.:  TODO Renew the passport                        :home:
  agenda:     In   7 d.:  TODO Book the venue                            :work:
  agenda:     In  22 d.:  TODO Submit the grant report                   :work:
  agenda:     TODO Stretch                            * ** **!          :habit:
Tuesday    29 September 2026
  agenda:     12:30-13:30 Lunch with Sam
  agenda:     17:00 ┄┄┄┄┄ Piano lessons
  agenda:     Evening class
Wednesday  30 September 2026
  agenda:     14:00 ┄┄┄┄┄ Dentist
  agenda:     18:00 ┄┄┄┄┄ Gym
  agenda:     Scheduled:  TODO Book the venue                            :work:
  agenda:     Water the plants                                           :home:
Thursday    1 October 2026
  agenda:     17:00 ┄┄┄┄┄ Piano lessons
  agenda:     Deadline:   TODO Pay the rent                              :home:
  agenda:     (1/3):  Conference                                         :work:
  agenda:     Book club
Friday      2 October 2026
  agenda:     16:00 ┄┄┄┄┄ Scheduled:  TODO Weekly review                 :work:
  agenda:     18:00 ┄┄┄┄┄ Gym
  agenda:     Deadline:   TODO Renew the passport                        :home:
  agenda:     (2/3):  Conference                                         :work:
  agenda:     Water the plants                                           :home:
  agenda:     Ana turns 36
Saturday    3 October 2026
  agenda:     (3/3):  Conference                                         :work:
  holiday:    Shemini Atzeret
Sunday      4 October 2026
  agenda:     22:00 ┄┄┄┄┄ (1/2):  Night train
  agenda:     Water the plants                                           :home:
  holiday:    Simchat Torah

Things to notice:

• "Clean the gutters" is Sched. 4x: but "Draft the newsletter" is missing: its -3d delay is not over until Wednesday.
• "Pay the electricity bill" is DONE: it shows on its day only.
• "File the insurance claim" is not in today's list: its deadline is more than 14 days away. It shows on 2026-10-30 (see the month below).
• "Book the venue" is there twice: its deadline warning today, its scheduled date on Wednesday.
• The ARCHIVE and COMMENT tasks and "Idea about the garden" (inactive) are missing.
• "Stretch" has its habit graph at column 40.

Try: <prefix>a < a= and compare, line by line.

The span starts at the day, week, month or year of the line under the cursor. In the calendar of gd, move with h j k l (H L change the month) and press <CR>, or press i and type a date such as 2026-10-12.

Try: in the agenda of this file press vd. Expect: only Monday 28 September, with the time grid, under the header Day-agenda (W40):. Press f: Tuesday, with "Lunch with Sam", "Piano lessons" and "Evening class". Press . to come back to today and vw for the week.

Try: in the week of Monday 2026-09-28 press f (the next week, 5 to 11 October) and then vm. Expect: Month-agenda (W40-W44):, the month of the cursor line: Thursday 1 October to Saturday 31 October. The second week reads:

Monday      5 October 2026 W41
  agenda:      6:30 ┄┄┄┄┄ (2/2):  Night train
  agenda:     18:00 ┄┄┄┄┄ Gym
  agenda:     Deadline:   TODO Book the venue                            :work:
Tuesday     6 October 2026
  agenda:     Water the plants                                           :home:
  agenda:     Evening class
Wednesday   7 October 2026
  agenda:     18:00 ┄┄┄┄┄ Gym
Thursday    8 October 2026
  agenda:     Water the plants                                           :home:
Friday      9 October 2026
  agenda:     16:00 ┄┄┄┄┄ Scheduled:  TODO Weekly review                 :work:
  agenda:     18:00 ┄┄┄┄┄ Gym
Saturday   10 October 2026
  agenda:     Water the plants                                           :home:
Sunday     11 October 2026

At the end, Friday 30 October 2026 has Deadline: TODO File the insurance claim and Saturday 31 October 2026 has holiday: Halloween. "Water the plants" is on every other day, "Weekly review" on every Friday, "Evening class" on every Tuesday, "Gym" on Mondays, Wednesdays and Fridays.

Try: press v<Space> and .. Expect: the week of today again.

Try: in the week agenda, move to "Call the plumber" and press <Tab>. Expect: this file opens in another window at "Call the plumber". Go back to the agenda (<C-w>p) and press F, then n a few times: the other window follows each item. F again turns it off.

Every change is made in the org buffer (not saved: save with <C-x><C-s> in the agenda or :wall) and the agenda line is updated. There is no undo key in the agenda: jump to the entry with <Tab> and press u there, or restore the file with git.

Mark several lines and act on all of them at once.

The actions after B: $ archive, A archive to the sibling, t TODO state, + / - add / remove a tag, r refile, s schedule, d deadline, S scatter over the next N days, f a Lua function, p keep the marks afterwards. s and d take a date, or ++1d to shift each entry's own date. Without marks, B acts on the entry at point.

Try: in the week agenda, press m on "Tidy the desk", "Sort the photos" and "Back up the laptop" (each gets a mark), then B, s, type ++1d and <CR>. Expect: "3 entries processed"; the three lines move from Monday to Tuesday, and their SCHEDULED: dates are now 2026-09-29 Tue.

Try: in the day agenda (vd) press %, type Sched and <CR>. Expect: "8 entries marked" (in the unchanged file): every line whose text contains "Sched" (Scheduled: and Sched. Nx:, the standup at 9:30 too). U unmarks them.

Filters hide lines without rebuilding the view. They show in the window bar (the top line of the window). | removes all of them.

A count changes a filter: 1\ (Emacs C-u \) excludes the tag, 2/ adds to the current filters. In /, +tag and -tag keep or hide a tag (or a category), <1:00 keeps efforts of at most one hour, >1:00 at least, and /text/ is a regexp. After \, <Space> means "any tag", ? "no tag" and . "the tags of this line".

The _ digits pick a value of the global Effort_ALL list 0 0:10 0:30 1:00 2:00 3:00 4:00 5:00 6:00 7:00 (1 is 0, 2 is 0:10, 3 is 0:30, …), not the #+PROPERTY: of this file. Entries without an effort count as infinitely long.

All the examples below start from the TODO list of this file, <prefix>a < t=, and end by removing the filters with |.

Try: \ then w. Expect: the ten work entries, from "Fix the production outage" to "Build the prototype". The last two show :work::: they inherit the tag from "Project Alpha" (inherited tags come before the ::).

Try: 1\ then h. Expect: every entry except the home ones: "Call the plumber", "Clean the gutters", "Renew the passport" … are gone; fifteen remain.

Try: _, <, 3. Expect: only the entries with an effort of at most 0:30:

agenda:     TODO [#B] Review the pull request                          :work:
agenda:     TODO Buy kumquats                                        :errand:

Try: / and type +work<1:00 <CR>. Expect: work entries with an effort of at most one hour: "Fix the production outage" (1:00) and "Review the pull request" (0:30).

Try: / and type -work/the/ <CR>. Expect: the entries without the work tag whose text contains "the": eleven lines, from "Call the plumber" to "Clean the garage".

Try: = and type garage <CR>. Expect: only "Clean the garage". = again removes the regexp filter.

Try: move to "Write the spec" and press ^. Expect: "Write the spec" and "Build the prototype": the open TODOs under the same top-level heading ("Stuck projects").

Try: in the week agenda without restriction (<prefix>a a), put the cursor on a line starting with agenda: and press <. Expect: only this file's lines remain (minus the holiday: ones). < again shows everything.

~ limits the number of lines: e entries, t TODOs, T tagged entries, E a total effort in minutes. A count (1~) removes the limits. Lines without the property (the time grid too) disappear while a limit is on.

Try: in the TODO list of this file press ~, e, type 3 and <CR>. Expect: only the first three entries: "Fix the production outage", "Call the plumber", "Team standup". 1~ shows all of them again.

Each key toggles its mode and says so (Log mode on, …).

<C-c><C-x><C-c> shows every line of the agenda as columns, like column view in an org buffer. The format comes from the #+COLUMNS: line of this file: %40ITEM %TODO %3PRIORITY %Effort{:} %TAGS. The column titles are in the window bar. While it is on, e edits the value under the cursor, n / p (<S-Right> / <S-Left>) cycle through the allowed values (Effort_ALL), v shows the full value and q turns it off.

Try: <prefix>a < t=, then <C-c><C-x><C-c>. Expect: the window bar reads ITEM | TODO | PR… | Effort | TAGS; "Fix the production outage" shows A as priority and 1:00 as effort.

Try: move to the Effort column of "Clean the garage" and press p. Expect: its effort goes from 4:00 to 2:00 (the previous value of Effort_ALL); the :Effort: property of the entry changes too. q leaves column view.

t in the dispatcher lists every entry with a not-done TODO keyword, dated or not, sorted by urgency (priority A first), then in file order. T asks for keywords (WAITING, or several: NEXT|WAITING).

Try: <prefix>a < t=. Expect:

Global list of TODO items of type: ALL
Press ‘N r’ (e.g. ‘0 r’) to search again: (0)[ALL] (1)... (2)...
                      ... (the numbered TODO keywords)
  agenda:     NEXT [#A] Fix the production outage                 :work:urgent:
  agenda:     TODO Call the plumber                                      :home:
  agenda:     TODO Team standup                                          :work:
  agenda:     TODO Return the library books                            :errand:
  agenda:     TODO Clean the gutters                                     :home:
  agenda:     TODO Draft the newsletter                                  :work:
  agenda:     TODO Renew the passport                                    :home:
  agenda:     TODO Submit the grant report                               :work:
  agenda:     TODO File the insurance claim                              :home:
  agenda:     TODO Send the birthday card                              :errand:
  agenda:     TODO Book the venue                                        :work:
  agenda:     TODO Weekly review                                         :work:
  agenda:     TODO Pay the rent                                          :home:
  agenda:     TODO Stretch                                              :habit:
  agenda:     TODO Tidy the desk                                         :home:
  agenda:     TODO Sort the photos                                       :home:
  agenda:     TODO Back up the laptop                                    :work:
  agenda:     TODO [#B] Review the pull request                          :work:
  agenda:     WAITING Reply from the landlord                            :home:
  agenda:     TODO Buy kumquats                                        :errand:
  agenda:     TODO Order new glasses                            :errand:urgent:
  agenda:     TODO Write the spec                                       :work::
  agenda:     TODO Build the prototype                                  :work::
  agenda:     TODO [#C] Clean the garage                                 :home:

The two header lines number the keywords: N r (e.g. 2 r) rebuilds the list for the Nth keyword, 0 r for all of them. The numbers depend on the keywords of the files in the view, so read them from the header. "Stretch" is a TODO too; "Pay the electricity bill" (DONE) and "Migrate the wiki" (CANCELLED) are not listed.

Try: in the TODO list, press the number shown before WAITING and r. Expect: only "WAITING Reply from the landlord".

Try: <prefix>a < T= and type NEXT|WAITING <CR>. Expect: two lines: "NEXT [#A] Fix the production outage" and "WAITING Reply from the landlord".

Options that hide dated entries from the TODO list: agenda.todo_ignore_scheduled, todo_ignore_deadlines, todo_ignore_timestamp and todo_ignore_with_date.

m in the dispatcher asks for a match string and lists the headings that match (TODO or not); M lists only the not-done TODO entries. The match syntax is shared with sparse trees and clock tables (10-sparse-trees.org covers it in depth). <Tab> at the prompt completes tags and property names.

| means "or": errand|urgent finds either tag.

In matches, a number such as 1:00 compares as its leading number (1), and a quoted value ("1:00") compares as a string, where a missing property is the empty string. So Effort<"1:00" also matches every heading without an effort; use Effort<*1 (the * requires the property to exist).

Try: <prefix>a < m= and type CLIENT"ACME"= <CR>. Expect: one line, NEXT [#A] Fix the production outage.

Try: <prefix>a < m= and type errand|urgent <CR>. Expect:

agenda:     NEXT [#A] Fix the production outage                 :work:urgent:
agenda:     TODO Return the library books                            :errand:
agenda:     TODO Send the birthday card                              :errand:
agenda:     TODO Buy kumquats                                        :errand:
agenda:     TODO Order new glasses                            :errand:urgent:

Try: m with Effort<*1, then with Effort>=2. Expect: "Review the pull request" and "Buy kumquats"; then "Write the spec" and "Clean the garage".

Try: m with DEADLINE<"<+1w>"=. Expect: "Renew the passport", "Send the birthday card", "Book the venue", "Pay the rent" (due by 2026-10-05, or overdue).

Try: m with SCHEDULED<"<today>". Expect: "Return the library books", "Clean the gutters", "Draft the newsletter".

Try: m with LEVEL=2+errand. Expect: "Buy kumquats" and "Order new glasses" (the other errands are at level 3).

Try: m with +home/-TODO. Expect: "DONE Pay the electricity bill", "Water the plants" (no keyword) and "WAITING Reply from the landlord".

Try: M with +work. Expect: the ten open work TODOs, as with the \ w filter above. With m instead, "Conference", "Migrate the wiki", "Project Alpha" and "Kick-off meeting" are listed too (they are not open TODOs).

In a match view, [ and ] add a +tag / -tag term to the query and rebuild it; 1 r edits the query.

s searches the text of the entries (headline and body) and lists the entries that match. Matching ignores case.

• A plain query is a phrase: noodle bar finds "noodle bar"; the spaces match any whitespace, line breaks included.
• A query starting with +, - or { is boolean: +word must occur, -word must not, {regexp} is an Emacs regexp, a phrase in double quotes is one word.
• A leading * searches headlines only, ! TODO entries only (like S), and : matches whole words only (in a boolean query).

This section contains the words it searches for, so its own heading, "Search view", is found as well.

Try: <prefix>a < s= and type kitchen <CR>. Expect: four lines: "Call the plumber" (its note mentions the kitchen tap), "Entry text" (it quotes that note), "Search view" and "Notes about the budget".

Try: s with +kitchen -tap. Expect: "Notes about the budget" only: the plumber note, "Entry text" and this section all mention the tap.

Try: s with {marmal[a-z]+}. Expect: "Buy kumquats" (its note says "For the marmalade recipe") and "Search view".

Try: s with *kumquats, then with *kitchen. Expect: "TODO Buy kumquats"; then nothing, since no headline contains "kitchen".

Try: S with kitchen. Expect: only "TODO Call the plumber" (TODO entries only).

Try: s with +adapt, then with :+adapt. Expect: "Conference" (its note mentions the power adapter) and "Search view"; then only "Search view", because "adapter" does not contain the whole word "adapt" (this paragraph does).

In the search view, [ / ] add a +word / -word term, { / } a +{regexp} / -{regexp} term, and 1 r starts a fresh search.

A project is stuck when nothing in it is ready to be worked on. examples/minimal_init.lua sets:

agenda = { stuck_projects = { match = "+project/-DONE" } }
-- and, at the top level: tags_exclude_from_inheritance = { "project" }

so a project is a heading tagged :project: that is not DONE, and it is stuck unless a heading of its subtree has one of the keywords TODO, NEXT or NEXTACTION (stuck_projects.todo_keywords). The project tag is not inherited, so the tasks of a project are not projects themselves.

Try: <prefix>a < #=. Expect: one line:

agenda:     Project Beta                                            :project:

"Project Alpha" has TODO tasks, "Project Gamma" is DONE.

Try: on "Notes about the budget" below press cit (the next TODO state) to make it a TODO. Then <prefix>a < #= again. Expect: the list is empty: "Project Beta" is no longer stuck.

• n: the agenda and the TODO list in one buffer (two blocks).
• /: a regexp searched in every line of every agenda file, into the quickfix list (:copen, :cnext). Not restricted by <.
• *: sticky agenda buffers: each view keeps its own buffer (org://agenda(KEY)) and is shown as it was when you open it again (r refreshes it).
• A inside an agenda appends another view to the current buffer.

Try: <prefix>a / and type kumquat <CR>. Expect: the quickfix window with the lines that contain "kumquat": in this file the headline, the search examples …, and lines of any other example file that mentions it.

Try: <prefix>a < n=. Expect: the week agenda, a separator line of ─, then the TODO list of this file. <C-Down> / <C-Up> jump between the two blocks.

Custom commands combine views and options under a key of the dispatcher. examples/minimal_init.lua defines two:

agenda = {
  custom_commands = {
    -- a block agenda: three views in one buffer
    w = {
      description = "Work overview",
      types = {
        { type = "agenda", span = "day", header = "Today" },
        { type = "tags_todo", match = "+work/!", header = "Open work tasks" },
        { type = "todo", match = "WAITING", header = "Waiting for" },
      },
    },
    -- a single tags view
    u = { description = "Urgent", type = "tags", match = 'PRIORITY="A"|+urgent' },
  },
}

Try: <prefix>a < u=. Expect:

Headlines with TAGS match: PRIORITY="A"|+urgent
Press ‘1 r’ to search again
  agenda:     NEXT [#A] Fix the production outage                 :work:urgent:
  agenda:     TODO Order new glasses                            :errand:urgent:

Try: <prefix>a < w=. Expect: three blocks separated by a line of ─. First "Today": the day agenda of today, as in The week at a glance for Monday. Then:

Open work tasks
  agenda:     NEXT [#A] Fix the production outage                 :work:urgent:
  agenda:     TODO Team standup                                          :work:
  agenda:     TODO Draft the newsletter                                  :work:
  agenda:     TODO Submit the grant report                               :work:
  agenda:     TODO Book the venue                                        :work:
  agenda:     TODO Weekly review                                         :work:
  agenda:     TODO Back up the laptop                                    :work:
  agenda:     TODO [#B] Review the pull request                          :work:
  agenda:     TODO Write the spec                                       :work::
  agenda:     TODO Build the prototype                                  :work::

───────────────────────────────────────────────────────────────────────────────
Waiting for
  agenda:     WAITING Reply from the landlord                            :home:

More options for your own config (:h org-agenda-custom-commands):

agenda = {
  custom_commands = {
    p = "Personal",                     -- a group: press p, then a key
    pa = {
      description = "Three days, home only",
      type = "agenda",
      span = 3,
      start_day = "-1",                 -- start yesterday
      tag_filter_preset = { "+home" },  -- a filter that stays on
    },
    pn = { description = "NEXT actions", type = "todo", match = "NEXT" },
    ps = { description = "Garden notes", type = "search", match = "garden" },
    pt = { description = "Work tree", type = "tags-tree", match = "+work" },
    r = {
      description = "Review",
      types = {
        { type = "agenda", span = "week", header = "This week" },
        { type = "stuck", header = "Stuck" },
        {
          type = "todo",
          header = "Unscheduled",
          skip = require("org.agenda").skip_entry_if("scheduled", "deadline"),
        },
      },
      settings = { prefix_format = " %-10:c %s" },
      export_files = { "~/review.html", "~/review.txt" },
    },
  },
}

• types (or blocks) makes a block agenda; type a single view. Types: agenda, todo, tags, tags_todo, search, stuck, and the sparse trees tags-tree, todo-tree, occur-tree of the current buffer.
• skip hides entries; require("org.agenda").skip_entry_if and skip_subtree_if take conditions like Emacs's org-agenda-skip-entry-if: scheduled, notscheduled, deadline, timestamp, regexp, todo …
• settings apply to every block; export_files are written by e in the dispatcher.

The dispatcher's < restricts one view. The restriction lock restricts every agenda command until you remove it, :Org agenda commands included.

On a line before the first heading, or with a count, the lock takes the whole file.

Try: put the cursor on the heading "Tasks without dates" and press <C-c><C-x><. Expect: the message Agenda restricted to subtree "Tasks without dates". Now <prefix>a t (no < needed) lists only the six open tasks of that subtree, and <prefix>a a shows an empty week (those tasks have no dates), only the time grid of today. Press <C-c><C-x>> to remove the lock.

<C-x><C-w> in the agenda writes the current view to a file; the extension picks the format: .txt (the text), .html (with colours), .org (the subtrees of the entries), .ics (iCalendar), .ps / .pdf (printed like Emacs, without external programs). :Org agenda export FILE does the same.

Try: in the day agenda of this file (<prefix>a < a= then vd), press <C-x><C-w> and type /tmp/today.txt. Expect: "Plain text written to /tmp/today.txt"; the file holds the agenda text, starting with Day-agenda (W40):. Try /tmp/today.html and /tmp/today.ics as well ("iCalendar written to …").

Custom commands with export_files are all written at once by e in the dispatcher, or from the shell:

nvim --headless -u examples/minimal_init.lua \
  -c "lua require('org.agenda.export').batch('a', { span = 'day' })" -c q

• :h org-agenda the dispatcher, :h org-agenda-contents what shows up
• :h org-agenda-keys every key, :h org-agenda-filter, :h org-agenda-limits, :h org-agenda-bulk, :h org-agenda-columns
• :h org-agenda-prefix the line format, :h org-agenda-sorting
• :h org-agenda-custom-commands, :h org-stuck-projects, :h org-agenda-search, :h org-match-syntax
• :h org-agenda-diary-sexp, :h org-agenda-holidays, :h org-agenda-calendar-keys (gC, M, S, H on a date)
• :h org-agenda-export, :h org-agenda-window
• :h org-agenda-unsupported what the agenda does not do