loom.nvim

loom.nvim is a Neovim plugin that enhances your workflow by allowing you to quickly switch between predefined projects using the Telescope picker. You can customize project paths, keybindings, and easily open projects in splits, tabs, or the current window.

Open the project picker

Open the options picker

Result (project1 on top et project2 on the bottom)

---

Installation

Ensure you have Telescope installed, as it is a dependency for this plugin.

Using lazy.nvim:

return {
  "DannickBedard/loom.nvim",
    dependencies = { 
        "nvim-telescope/telescope.nvim",
        "nvim-lua/plenary.nvim" 
    },
  config = function()
    local projects = {
      { name = "project1", path = "~/Documents/project1" },
      { name = "project2", path = "~/Documents/project1" },
    }

    local keymaps = {
      open_picker = "<leader>fp",          -- Open the project picker
      picker_open_split = "<C-s>",        -- Open project in a split (inside the picker)
      picker_open_vsplit = "<C-v>",       -- Open project in a vertical split (inside the picker)
      picker_open_tab = "<C-t>",          -- Open project in a new tab (inside the picker)
      picker_open_current_win = "<C-w>", -- Open project in the current window (inside the picker)

      open_in_split = "<leader>ops",      -- Directly open picker for horizontal split
      open_in_vsplit = "<leader>opv",     -- Directly open picker for vertical split
      open_in_tab = "<leader>opt",        -- Directly open picker for a tab
      open_in_current_win = "<leader>opw" -- Directly open picker for the current window
    }

    require("loom").setup({
      keymaps = keymaps,
      projects = projects,
    })
  end,
}

API

local loom = require("loom")

-- Add current project working dir to the dynamic projects
vim.keymap.set('n', 'yourKeyMap', loom.add_project_to_local_storage)

-- Open pane listing the dynamic project. In this pane you can edit the dynamic projects (name and path)
vim.keymap.set('n', 'yourKeyMap', loom.show_projects_pane)

---

Features

• Project Picker: Use Telescope to select and open predefined projects.
• Customizable Keybindings: Bind specific actions for opening projects in splits, tabs, or the current window.
• Action Prepend: Open the picker with predefined actions for quick navigation.

---

---

Keybindings

Keybinding	Action
<leader>fp	Open the project picker
<C-S>	Open project in a horizontal split (inside picker)
<C-s>	Open project in a vertical split (inside picker)
<C-t>	Open project in a new tab (inside picker)
<C-w>	Open project in the current window (inside picker)
<leader>opS	Directly open picker for horizontal split
<leader>ops	Directly open picker for vertical split
<leader>opt	Directly open picker for a tab
<leader>opw	Directly open picker for the current window

---

Future Improvements

• Add support for custom keymaps for specific projects. For example, within the project object, you could specify keymaps to open the project in a specific layout (e.g., split, new tab, etc.) directly without going through the picker.
• Add healthcheck support : https://neovim.io/doc/user/health.html#health-dev

---

Enjoy seamless project navigation with loom.nvim!

TODOS :

Dynamic project :

• Make a json file to store project
• keybind to add current workdir into the json file
• keybind to remove current workdir from the json file
• keybind to promt a harpoon like editor to edit the project list.
  • structure => Name -> filepath
• keybind to put in the clipboard the current dynamic config into settings for the plugin. If you wan to add more permanent project