How do I change key bindings for org-mode agenda view?

Question

org-mode agenda view has a bunch of commands accessible with a single key press.

E.g. typing b moves backward in time to display earlier dates, and typing t brings up a dialog to change the TODO state of the item.

I would like to redefine t to toggle between TODO and DONE without any dialog, and also redefine b to reschedule a task at focus to the next week.

How can those built-in commands be redefined?

Answer 1

You can do that in two steps:

1. define a function to change the state
2. map the function to b in org-agenda-mode

Define a function to change the state

(defun my/org-agenda-todo-done ()
  (interactive)
  (org-agenda-todo 'done))

org-todo and org-agenda-todo takes arguments. Of which, you can define the state.

Map the function to b in org-agenda-mode

(add-hook 'org-agenda-mode-hook
          (lambda ()
                  (local-set-key (kbd "b") 'my/org-agenda-todo-done)))

Bind the function to the key of your choice. Make sure to add your key to the org-agenda-mode-map. local-set-key on the hook will do.

Note that b is mapped to org-agenda-earlier in default. If you don't want to lose it, remap to another key.