1. Clone the repository

git clone https://github.com/aravindps/org-gtd ~/dotfiles/org-gtd

2. Create your gtd.org

#+TITLE: GTD
#+TODO: PROJECT NEXT WAIT SOMEDAY | DONE CANCELLED
#+TAGS: @home(h) @office(f) @standup(s) @ask(a)
Inbox

My First Project
** NEXT First task :@office:
** NEXT Second task :@ask:

3. Load from your Emacs config

Set my/gtd-file before loading anything. This variable is required — loading without it will cause errors.

Doom Emacs (~/.config/doom/config.el):

(setq my/gtd-file "~/path/to/your/gtd.org")

(load "~/dotfiles/org-gtd/org-gtd.el")        ;; always load first (load "~/dotfiles/org-gtd/bindings-cmd.el")   ;; ⌘ keys (GUI/macOS) (load "~/dotfiles/org-gtd/bindings-ccg.el")   ;; C-c g prefix (load "~/dotfiles/org-gtd/bindings-f5.el")    ;; F5 prefix (load "~/dotfiles/org-gtd/bindings-doom.el")  ;; SPC leader (Doom only) (load "~/dotfiles/org-gtd/doom-overrides.el") ;; Doom/evil conflict fixes (load last)

Vanilla Emacs — GUI (~/.emacs or ~/.emacs.d/init.el):

(setq my/gtd-file "~/path/to/your/gtd.org")

(load "~/dotfiles/org-gtd/org-gtd.el") (load "~/dotfiles/org-gtd/bindings-cmd.el") (load "~/dotfiles/org-gtd/bindings-ccg.el")

Vanilla Emacs — terminal:

(setq my/gtd-file "~/path/to/your/gtd.org")

(load "~/dotfiles/org-gtd/org-gtd.el") (load "~/dotfiles/org-gtd/bindings-ccg.el") (load "~/dotfiles/org-gtd/bindings-f5.el")

Mouse in terminal — add (xterm-mouse-mode 1) to your config to enable mouse support. Works in iTerm2 and most modern terminals.

4. Configuration

| Variable | Default | Purpose | |----------|---------|---------| | my/gtd-file | nil | Required. Path to your GTD org file. | | my/gtd-open-on-startup | t | Open gtd.org automatically on Emacs launch. Set to nil to disable. |

5. Restart Emacs

Doom users: run doom sync before restarting.

Views

| Action | ⌘ (GUI) | C-c g / F5 | SPC (Doom) | |--------|---------|------------|------------| | Open Inbox | ⌘ i | … i | SPC i | | Dashboard | ⌘ / | … / | SPC / | | Inbox view | ⌘ 0 | … 0 | SPC 0 | | Today | ⌘ 1 | … 1 | SPC 1 | | Upcoming | ⌘ 2 | … 2 | SPC 2 | | Anytime (NEXT, no date) | ⌘ 3 | … 3 | SPC 3 | | Waiting (blocked) | ⌘ 4 | … 4 | SPC 4 | | Someday | ⌘ 5 | … 5 | SPC 5 | | Logbook | ⌘ 6 | … 6 | SPC 6 | | Context → NEXT tasks | ⌘ 7 | … 7 | SPC 7 | | Context → all tasks | ⌘ 8 | … 8 | SPC 8 |

Create

| ⌘ (GUI) | C-c g / F5 | SPC (Doom) | Action | |---------|------------|------------|--------| | ⌘ n | … n | SPC n | New sibling heading (NEXT) | | ⌘ N | … N | SPC N | New child task (NEXT) | | ⌘ C | … c | SPC c | New checklist item | | ⌥ ⌘ a | … a | SPC a | New top-level project |

Edit

| ⌘ (GUI) | C-c g / F5 | SPC (Doom) | Action | |---------|------------|------------|--------| | ⌘ e | … e | SPC e | State picker (NEXT / WAIT / SOMEDAY / DONE / CANCEL / Promote) | | ⌘ k | … k | SPC k | Complete → auto-sinks | | ⌥ ⌘ k | … K | SPC K | Cancel → auto-sinks | | ⌘ ' | … ' | SPC ' | Toggle hide DONE/CANCELLED | | ⌘ d | … d | SPC d | Duplicate subtree | | ⇧⌘Y | … Y | SPC Y | Archive subtree (Shift+y everywhere; harder to hit by mistake) |

Move

| ⌘ (GUI) | C-c g / F5 | SPC (Doom) | Action | |---------|------------|------------|--------| | ⇧⌘M | … M | SPC M | Refile to project (Shift+m on every layer; Doom SPC m free) | | ⌘ ↑ | … <up> | SPC <up> | Move subtree up | | ⌘ ↓ | … <down> | SPC <down> | Move subtree down | | ⌘{ | … { | SPC { | Move subtree to top among siblings | | ⌘} | … } | SPC } | Move subtree to bottom among siblings |

Dates

| ⌘ (GUI) | C-c g / F5 | SPC (Doom) | Action | |---------|------------|------------|--------| | ⌘ s | … s | SPC s | Schedule (date picker) | | ⌘ t | … t | SPC t | Start Today | | ⌘ r | … r | SPC r | Anytime (remove schedule) | | ⌘ o | … o | SPC o | Someday | | ⌘ D | … D | SPC D | Deadline |

Navigate

| ⌘ (GUI) | C-c g / F5 | SPC (Doom) | Action | |---------|------------|------------|--------| | ⌘ → | — | — | Narrow to subtree | | ⌘ ← | — | — | Widen to full file | | — | … - | SPC - | Toggle narrow/widen | | ⌘ | — | — | Go back (winner-undo) | | ⌘ f | … f | — | Search headings | | ⌃ ⌘ o | — | — | Switch GTD file |