*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: