telescope-project.nvim

An extension for telescope.nvim that allows you to switch between projects.

Demo

You can setup the extension by adding the following to your config:

require'telescope'.load_extension('project')

You may skip explicitly loading extensions (they will then be lazy-loaded), but tab completions will not be available right away.

The projects picker:

require'telescope'.extensions.project.project{}

Key	Description
`d`	delete currently selected project
`r`	rename currently selected project
`c`	create a project*
`s`	search inside files within your project
`b`	browse inside files within your project
`w`	change to the selected project's directory without opening it
`R`	find a recently opened file within your project
`f`	find a file within your project (same as <CR>)

* defaults to your git root if used inside a git project, otherwise, it will use your current working directory

Example key map config:

vim.api.nvim_set_keymap(
    'n',
    '<C-p>',
    ":lua require'telescope'.extensions.project.project{}<CR>",
    {noremap = true, silent = true}
)

Keys	Description	Options
`display_type`	Show the title and the path of the project	'full' or 'minimal' (default)

Options can be added when requiring telescope-project, as shown below:

lua require'telescope'.extensions.project.project{ display_type = 'full' }

Keys	Description	Options
`base_dir`	path to projects (all git repos will be added)	string (default: nil)
`max_depth`	maximum depth to recursively search for projects	integer (default: 3)

Setup settings can be added when requiring telescope, as shown below:

require('telescope').setup {
  extensions = {
    project = {
      base_dir = '~/projects',
      max_depth = 3
    }
  }
}