duguyue100/planning.nvim — explained in plain English
Analysis updated 2026-05-18
Jot quick daily to-dos or project notes without leaving Neovim.
Track multi-day tasks or projects using date range entries with a status you can cycle through.
Keep a lightweight local planning calendar stored as plain JSON, with no external services or dependencies.
Customize the calendar's data file location and highlight colors to match your setup.
| duguyue100/planning.nvim | agalaxie/battlegroundtargets-coa | rajatcing/resolve-audio-denoiser | |
|---|---|---|---|
| Stars | 2 | 2 | 2 |
| Language | Lua | Lua | Lua |
| Setup difficulty | easy | easy | moderate |
| Complexity | 1/5 | 1/5 | 3/5 |
| Audience | developer | general | general |
Figures from each repo's GitHub metadata at analysis time.
Requires Neovim 0.9 or newer, no other plugins are needed to run it.
planning.nvim is a small, dependency free planning calendar built as a plugin for the text editor Neovim. It opens a floating month grid inside your editor that you can move around using the familiar h, j, k, l movement keys, letting you jump between days and add short notes to each one. Each note has a status of New, In Progress, or Done, and can either sit on a single day or span a range of days, such as a project that runs from one date to another. Everything you add is saved automatically to a local JSON file every time you make a change. To use it you need Neovim version 0.9 or newer, and no other plugins are required, though the plugin will style its text prompts nicely if you already use certain input styling plugins. It installs like any other Neovim plugin, for example through the lazy.nvim plugin manager, or by cloning the repository yourself. Once installed, running the command Planning opens the calendar centered on the current month with today's date already focused. Inside the calendar, dedicated keys let you move between days, jump to the next or previous month, jump to a specific month, open a day to see its details, add a new entry, or close the calendar. Opening a day shows its entries in a detail view, where you can add, edit, delete, or reorder entries, and cycle an entry's status from New to In Progress to Done. When adding an entry, you are asked for the entry's text and, optionally, a date range, which can be written in a few different short formats and even span across months. The plugin lets you customize where its data file is saved, and lets you override the colors used to highlight today's date and the currently focused cell in the calendar. Data is stored as plain JSON with entries organized by single days and by date ranges, and any existing files from an older, simpler storage format are automatically converted the first time they are loaded. The project is released under the MIT license.
A lightweight, dependency free Neovim plugin that adds a floating month calendar for jotting quick tasks with New, In Progress, or Done status.
Mainly Lua. The stack also includes Lua, Neovim.
MIT licensed: you can use, modify, and share the code freely, including commercially, as long as you keep the copyright notice.
Setup difficulty is rated easy, with roughly 5min to a first successful run.
Mainly developer.
This repo across BitVibe Labs
Don't trust strangers blindly. Verify against the repo.