A Kanban board is a visual way to manage tasks and workflows. It breaks your work into cards (representing tasks) and organizes them into columns (representing stages, like “Todo”, “Doing”, “Done”).

Each card can represent a task, feature, or idea, and moves across the board as its status changes. Why use Kanban?

• See everything at a glance - from what's coming up to what's done
• Stay focused by limiting what you’re working on
• Easily rearrange tasks as priorities change
• Organize projects into structured, manageable pieces

Whether you’re tracking personal todos or planning a complex project, a Kanban board helps keep things clear and actionable.

If you’re new to Kanban, this video introduction is highly recommended - it explains the basics clearly and is perfect for beginners!

• Keyboard-centric Kanban workflow built for Neovim
• Tree-sitter based parsing for Markdown and Orgmode (neorg coming soon)
• Compatible with Obsidian Kanban-style markdown
• Supports tags, checkmarks, due dates, sorting or archiving cards
• Built-in date picker for assigning due dates (press @ in insert mode)
• Create dedicated notes for each card to store additional context
• Time tracking support to log and review time spent on each task (coming soon)

• snacks.nvim - search & component layout engine
• Tree-sitter parser for markdown or org

• orgmode.nvim - for Org file support
• flash.nvim - for enhanced jump navigation (see Flash integration)

{
  "hasansujon786/super-kanban.nvim",
  dependencies = {
    "folke/snacks.nvim",           -- [required]
    "nvim-orgmode/orgmode",        -- [optional] Org format support
  },
  opts = {}, -- optional: pass your config table here
}

require("mini.deps").add({
  source = "hasansujon786/super-kanban.nvim",
  depends = {
    { source = "folke/snacks.nvim" },       -- [required]
    { source = "nvim-orgmode/orgmode" },    -- [optional]
  },
})

Start by creating your first Kanban board file:

:SuperKanban create <FILE_PATH>

Then open the board with:

:SuperKanban open <FILE_PATH>

You can add a new task with gn (create after), and navigate between tasks using <C-h/j/k/l>.

To move cards across the board, use <A-h/j/k/l>. Want to quickly jump around? Use <C-k>, G, gg, and more.

To assign a due date, press @ in insert mode inside a card.

Each task card:

• Uses the first line as the card title
• Treats any @{date} string as a due date
• Interprets #tag style words as tags

See the Default Keymaps section below for all available shortcuts.

Call setup() in your config file to customize behavior:

require("super-kanban").setup({
  markdown = {
    notes_dir = "./tasks/",
    list_heading = "h2",
    default_template = {
      "## Backlog\n",
      "## Todo\n",
      "## Work in progress\n",
      "## Completed\n",
    },
  },
  mappings = {
    ["<cr>"] = "open_note",
    ["gD"] = "delete_card",
    ["<C-t>"] = "toggle_complete",
  },
})

{
  markdown = {...},     -- Settings for working with Markdown kanban files
  org = {...},          -- Settings for working with Org kanban files
  card = {...},         -- Window style and behavior for cards
  list = {...},         -- Layout and options for lists
  board = {...},        -- Main board window layout and styling
  date_picker = {...},  -- Appearance and options for the date picker
  note_popup = {...},   -- Settings for the card note popup
  icons = {...},        -- Customize UI icons (borders, arrows, etc.)
  mappings = {...},     -- Custom keymaps for user actions
}

See :h super-kanban-config-defaults in the help file for all available options.

Define custom mappings using the mappings option. Each mapping can be:

• a string (built-in action name)
• a table: with a callback function and optional mapping options
• false (to disable the default)

Example:

mappings = {
  ['s'] = {
    callback = function()
      pick_window()
    end,
    desc = "Flash",
  },

  ['/'] = {
    callback = function(card, list, ctx)
      require("super-kanban.actions").search_card(card, list, ctx)
    end,
    nowait = true,
  },

  ['<cr>'] = false,
}

You can use all standard mapping options (desc, nowait, etc.)
See :h vim.keymap.set() and vim.keymap.set.Opts for details.

See :h :SuperKanban for subcommand details.

Programmatically interact with the plugin using Lua. You can open or create Kanban board files directly:

require("super-kanban").open("todo.md")        -- Open an existing board
require("super-kanban").create("my-board.md")  -- Create a new board file

• SuperKanbanNormal
• SuperKanbanListBorder
• SuperKanbanCardNormal
• SuperKanbanDatePickerCursor
• and more...

See :h super-kanban-highlight-groups for the full list.

You can integrate flash.nvim to jump between Kanban windows using label hints.

Example:

local function pick_window(callback)
  require('flash').jump({
    highlight = {
      backdrop = true,
      groups = {
        current = 'FlashLabel',
        label = 'FlashLabel',
      },
    },
    label = { after = { 0, 0 } },
    search = {
      mode = 'search',
      max_length = 0,
      multi_window = true,
      exclude = {
        function(win)
          local kanban_ft = { superkanban_list = true, superkanban_card = true }
          return not kanban_ft[vim.bo[vim.api.nvim_win_get_buf(win)].filetype]
        end,
      },
    },
    action = callback,
    matcher = function(win)
      return { { pos = { 1, 0 }, end_pos = { 1, 0 } } }
    end,
  })
end

-- Inside your plugin setup
{
  mappings = {
    ['s'] = {
      callback = function()
        pick_window()
      end,
      desc = 'Flash',
    },
  }
}

Feel free to open issues or PRs if you have ideas or find bugs. This plugin is still in early development, so feedback is welcome!

• Huge thanks to arakkkkk/kanban.nvim it was one of the first Neovim Kanban plugins I tried, and it inspired me to build my own take on the idea.