duguyue100/planning.nvim

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.