telescope-resession.nvim/doc/telescope-resession.txt

117 lines
3.9 KiB
Plaintext

*telescope-resession.txt* For Neovim >= 0.9.0 Last change: 2024
==============================================================================
Table of Contents *telescope-resession-table-of-contents*
1. telescope-resession.nvim |telescope-resession-telescope-resession.nvim|
- Extension Installation|telescope-resession-telescope-resession.nvim-extension-installation|
- Recommended Resession Configuration|telescope-resession-telescope-resession.nvim-recommended-resession-configuration|
- Usage |telescope-resession-telescope-resession.nvim-usage|
- Customization |telescope-resession-telescope-resession.nvim-customization|
2. Links |telescope-resession-links|
==============================================================================
1. telescope-resession.nvim *telescope-resession-telescope-resession.nvim*
A telescope extension that adds a session picker to the wonderful
resession.nvim <https://github.com/stevearc/resession.nvim> plugin.
EXTENSION INSTALLATION*telescope-resession-telescope-resession.nvim-extension-installation*
>lua
{
"nvim-telescope/telescope.nvim",
dependencies = { "scottmckendry/telescope-resession.nvim" },
config = function()
telescope.setup({
-- Other telescope config...
extensions = {
resession = {
prompt_title = "Find Sessions", -- telescope prompt title
dir = "session", -- directory where resession stores sessions
},
},
},
})
end,
}
<
RECOMMENDED RESESSION CONFIGURATION*telescope-resession-telescope-resession.nvim-recommended-resession-configuration*
>lua
return {
"stevearc/resession.nvim",
config = function()
local resession = require("resession")
resession.setup({})
-- Automatically save sessions on by working directory on exit
vim.api.nvim_create_autocmd("VimLeavePre", {
callback = function()
resession.save(vim.fn.getcwd(), { notify = true })
end,
})
-- Automatically load sessions on startup by working directory
vim.api.nvim_create_autocmd("VimEnter", {
callback = function()
-- Only load the session if nvim was started with no args
if vim.fn.argc(-1) == 0 then
resession.load(vim.fn.getcwd(), { silence_errors = true })
end
end,
nested = true,
})
end,
}
<
USAGE *telescope-resession-telescope-resession.nvim-usage*
Vim command:
>vim
:Telescope resession
<
Lua:
>lua
require("telescope").extensions.resession.resession()
<
**Prompt Key Maps:**
Mode Key Mapping Description
---------------- ------------- -----------------------------
Normal, Insert <CR> Load the selected session
Normal, Insert <C-d> Delete the selected session
CUSTOMIZATION *telescope-resession-telescope-resession.nvim-customization*
>lua
extensions = {
resession = {
prompt_title = "Your custom prompt title",
-- Apply custom path substitutions to the session paths
path_substitutions = {
{ find = "/home/username", replace = "🏠" },
},
},
},
<
==============================================================================
2. Links *telescope-resession-links*
1. *image*: https://github.com/scottmckendry/telescope-resession.nvim/assets/39483124/93fb9c3d-1345-4f74-a37d-b8e520116362
Generated by panvimdoc <https://github.com/kdheepak/panvimdoc>
vim:tw=78:ts=8:noet:ft=help:norl: