A customizable Telescope extension to list the git submodules of your current project and interact with them through the git TUI of your choice.

• List the git submodules of the currently opened project
• Preview the files changes for each submodule directly in Telescope
• Run the git TUI (or command) of your choice when selecting a submodule in Telescope
• Bypass Telescope if only one repo/submodule would be displayed in Telescope

Using lazy.nvim

return {
	"nvim-telescope/telescope.nvim",
	dependencies = {
		{
			"agoodshort/telescope-git-submodules.nvim",
			dependencies = "akinsho/toggleterm.nvim",
		},
	},
	config = function()
		require("telescope").load_extension("git_submodules")
	end,
}

The extension comes with the following defaults:

require("telescope").setup({
	extensions = {
		git_submodules = {
			git_cmd = "lazygit",
			terminal_id = 9,
		},
	},
})

• Keymap to trigger :DiffView for the highlighted submodule
• Support additional terminal plugins (e.g., nvim-terminal)

Inspired by lazygit.nvim