This is a telescope.nvim extension tabpages picker named tabman
.
This picker is similar to the builtin buffers
picker, but its focus is on tabpages and windows instead.
When a neovim user is having many split windows in different tabpages, switching between them using the buffers picker is usually difficult. Instead, by using the Tabman picker, user should be able to switch to the specific window on a specific tabpage.
I found this picker very useful when using neovim as an IDE, where different tabpages are usually holding different file types (e.g. js, css, json files on separate tabpages). In this case, switching by the buffers picker will mess up the workspace, and Tabman picker can speed up file switching and preserving the workspace layout.
Basic installation with Packer is as simple as:
-- download the repo
use 'quantumsnowball/telescope-tabman.nvim'
-- register the extension with telescope
require('telescope').load_extension('tabman')
To verify the installation is working, you should be able to run the picker by:
:Telescop tabman
Tabman as a telescope picker should be shown.
You can also call the picker in lua with telescope configs like this:
require('telescope').extensions.tabman.tabman()
or with some telescope picker options:
local opts = {
-- ... some telescope picker opts
}
require('telescope').extensions.tabman.tabman(opts)
Tabman does not come with defaualt keymaps, your need to define your own. Example of one-time setup up with the keymap of <leader>t
is as follows:
use {
'quantumsnowball/telescope-tabman.nvim',
config = function()
local opts = {
-- ... some telescope picker opts
}
vim.keymap.set('n', '<leader>t', function()
require('telescope').extensions.tabman.tabman(opts)
end)
end
}