quests.nvim

A lightweight Neovim plugin for viewing and managing tasks in a floating window.

quests.nvim keeps your task file close to your editor, so you can quickly check your list without leaving Neovim.

Features

• Open your task file in a centered floating window
• Simple, distraction-free interface
• Buffer-local close mappings
• Works with any markdown task file
• Minimal and dependency-free

Installation

lazy.nvim

{
  "VrajVed/quests.nvim",
  config = function()
    require("quests").setup({
      target_file = "~/your_target_file.md",
    })
  end,
}

Setup

Make sure your leader key is set to space if you want to use <Space>qs:

vim.g.mapleader = " "

Usage

Open your quests window with:

:Qs

Inside the floating window:

• q closes the window
• <leader>qs closes the window quickly

Configuration

target_file

Path to the file that quests.nvim opens.

require("quests").setup({
  target_file = "~/quests.md",
})

If the file does not exist, quests.nvim will show an error message.

Example task file

- [ ] Finish README
- [ ] Add task creation
- [ ] Improve floating window UI

Commands

Command	Description
:Qs	Open the configured task file in a floating window

Keymaps

These keymaps are set only inside the quests buffer:

Key	Action
q	Close the floating window
<leader>qs	Close the floating window

LICENSE

MIT