pending.nvim/README.md
Barrett Ruth 2321dab457 docs: document forge links feature
Problem: no user-facing documentation for forge link syntax,
configuration, or behavior.

Solution: add forge links section to `README.md` and `pending.txt`
covering shorthand/URL syntax, config options, virtual text
rendering, state pull, and auth resolution.
2026-03-10 17:44:54 -04:00

1.7 KiB

pending.nvim

Edit tasks like text.

Oil-like task management for todos in Neovim, inspired by oil.nvim and vim-fugitive

https://github.com/user-attachments/assets/f3898ecb-ec95-43fe-a71f-9c9f49628ba9

Features

  • Oil-style buffer editing: standard Vim motions for all task operations
  • Inline metadata: due:, cat:, rec: tokens parsed on :w
  • Rich date input: relative (+3d, tomorrow), weekdays, ordinals, custom formats, time suffixes
  • Recurring tasks with automatic next-date spawning on completion
  • Category and queue views with foldable sections
  • Multi-level undo (up to 20 saves, persisted across sessions)
  • Text objects (at/it/aC/iC) and motions (]]/[[/]t/[t)
  • Omnifunc completion for due:, cat:, and rec: tokens
  • Filters: cat:X, overdue, today, priority, wip, blocked
  • Google Calendar one-way push via OAuth PKCE
  • Google Tasks bidirectional sync via OAuth PKCE
  • S3 whole-store sync via AWS CLI with cross-device merge
  • Auto-authentication: sync actions trigger auth flows automatically
  • Forge links: reference GitHub/GitLab/Codeberg issues and PRs inline

Requirements

  • Neovim 0.10+
  • (Optionally) curl for Google Calendar and Google Tasks sync
  • (Optionally) aws CLI for S3 sync

Installation

Install with your package manager of choice or via luarocks:

luarocks install pending.nvim

Documentation

:help pending.nvim

Acknowledgements