{
  "jameswolensky/marker-groups.nvim",
  dependencies = {
    "nvim-lua/plenary.nvim", -- Required
    "ibhagwan/fzf-lua", -- Optional: fzf-lua picker
    "folke/snacks.nvim", -- Optional: Snacks picker
    "nvim-telescope/telescope.nvim", -- Optional: Telescope picker
    -- mini.pick is part of mini.nvim; this plugin vendors mini.nvim for tests,
    -- but you can also install mini.nvim explicitly to use mini.pick system-wide
    -- "nvim-mini/mini.nvim",
  },
  config = function()
    require("marker-groups").setup({
      -- Default picker is 'vim' (built-in vim.ui)
      -- Accepted values: 'vim' | 'snacks' | 'fzf-lua' | 'mini.pick' | 'telescope'
      picker = 'vim',
    })
  end,
}

use {
  "jameswolensky/marker-groups.nvim",
  requires = {
    "nvim-lua/plenary.nvim", -- Required
    "ibhagwan/fzf-lua", -- Optional
    "folke/snacks.nvim", -- Optional
    "nvim-telescope/telescope.nvim", -- Optional
    -- "nvim-mini/mini.nvim", -- Optional
  },
  config = function()
    require("marker-groups").setup()
  end,
}

-- Basic setup with defaults
require("marker-groups").setup()

-- Create a new group
:MarkerGroupsCreate feature-auth

-- Add a marker at current line
:MarkerAdd Implement JWT token validation

-- View all markers in drawer viewer
:MarkerGroupsView

-- List all groups
:MarkerGroupsList

require("marker-groups").setup({
  -- Persistence
  data_dir = vim.fn.stdpath("data") .. "/marker-groups",

  -- Logging
  debug = false,
  log_level = "info", -- "debug" | "info" | "warn" | "error"

  -- Drawer viewer
  drawer_config = {
    width = 60,        -- 30..120
    side = "right",    -- "left" | "right"
    border = "rounded",
    title_pos = "center",
  },

  -- Context shown around markers in viewer/preview
  context_lines = 2,

  -- Virtual text display & highlight groups
  max_annotation_display = 50, -- truncate long annotations
  highlight_groups = {
    marker = "MarkerGroupsMarker",
    annotation = "MarkerGroupsAnnotation",
    context = "MarkerGroupsContext",
    multiline_start = "MarkerGroupsMultilineStart",
    multiline_end = "MarkerGroupsMultilineEnd",
  },

  -- Keybindings (declarative; override per entry or disable by setting to false)
  keymaps = {
    enabled = true,
    prefix = "<leader>m",
    mappings = {
      marker = {
        add = { suffix = "a", mode = { "n", "v" }, desc = "Add marker" },
        edit = { suffix = "e", desc = "Edit marker at cursor" },
        delete = { suffix = "d", desc = "Delete marker at cursor" },
        list = { suffix = "l", desc = "List markers in buffer" },
        info = { suffix = "i", desc = "Show marker at cursor" },
      },
      group = {
        create = { suffix = "gc", desc = "Create marker group" },
        select = { suffix = "gs", desc = "Select marker group" },
        list = { suffix = "gl", desc = "List marker groups" },
        rename = { suffix = "gr", desc = "Rename marker group" },
        delete = { suffix = "gd", desc = "Delete marker group" },
        info = { suffix = "gi", desc = "Show active group info" },
        from_branch = { suffix = "gb", desc = "Create group from git branch" },
      },
      view = { toggle = { suffix = "v", desc = "Toggle drawer marker viewer" } },
      
    },
  },

  -- Picker backend (default: 'vim')
  -- Accepted values: 'vim' | 'snacks' | 'fzf-lua' | 'mini.pick' | 'telescope'
  -- Invalid values fall back to 'vim'.
  picker = 'vim',
})

-- Create a group for review comments
:MarkerGroupsCreate code-review

-- Add markers for issues found
:MarkerAdd TODO: Extract this function
:MarkerAdd FIXME: Handle edge case for empty array
:MarkerAdd NOTE: Consider performance optimization

-- Organize by feature branches
:MarkerGroupsCreate feature-user-auth
:MarkerAdd Implement login endpoint
:MarkerAdd Add password validation
:MarkerAdd Create user session management

-- Track bugs and fixes
:MarkerGroupsCreate bug-fixes
:MarkerAdd BUG: Memory leak in data processing
:MarkerAdd FIX: Null pointer exception handling