wurli/servery.nvim

github

session

63

2

0

4

CREATED

2026-09-25

UPDATED

2026-10-01

---

servery.nvim

Jump between Neovim sessions using your favourite fuzzy finder 💨

https://github.com/user-attachments/assets/17ae8112-29fa-4467-ad2b-98180412a127

The workflow

1. Configure the directories you want to appear in the UI
2. Use :Sv (or configure a keymap) to jump between them
3. Profit

Features

• Sessions outlive the terminal emulator unless you close them, e.g. with :qa

• Supports session management via a bunch of ui providers:

  • Built-in ui
  • Snacks/picker
  • fzf-lua
  • mini.pick
  • telescope

• :Sv does all the stuff

Install/configure

[!NOTE] servery.nvim requires nvim 0.12+. Display of server elapsed times requires 0.13+.

vim.pack (nvim 0.12+):

vim.pack.add({ "https://github.com/wurli/servery.nvim" })

-- The following are the defaults - you don't need to change them
-- but you probably should at least set `dirs` and `ui.provider`.
require("servery").setup({
    -- Either supply the directories as an array of strings, or a function
    -- which returns an array. Shorthands like `~` are expanded. The default
    -- lists the non-hidden dirs in your home directory.
    ---@type string[] | fun(): string[]
    dirs = function() return vim.fs.glob("~/*", true, true) end,
    session_dir = vim.fs.joinpath(vim.fn.stdpath("cache"), "servery.nvim"),
    -- Command and additional argument(s) used to start a new session. servery appends
    -- `--headless --listen {socket}`.
    -- default uses `vim.v.progpath` / current running nvim, user can add
    -- arguments here when neovim must be started through a wrapper, resolved
    -- from PATH, and / or needs extra startup setup, etc...
    ---@type string[]
    spawn_cmd = { vim.v.progpath },
    ui = {
        -- Options: "builtin" | "snacks" | "fzf" | "telescope" | "mini_pick"
        provider = "builtin", ---@type servery.ui_provider
        prompt = "Switch Nvim Session",
        icons = {
            current = "",
            active = "",
            inactive = "",
        },
        actions = {
            ["<enter>"] = "switch",
            ["<c-g>"] = "switch_and_detach",
            ["<c-x>"] = "detach",
            ["<c-s>"] = "spawn",
        },
        -- fzf-lua uses fzf's keymap notation, so it gets its own actions table
        fzf_actions = {
            ["enter"] = "switch",
            ["ctrl-g"] = "switch_and_detach",
            ["ctrl-x"] = "detach",
            ["ctrl-s"] = "spawn",
        },
    },
})

{
    "wurli/servery",
    opts = {
        dirs = { "~" },
        -- ... See above for more
    },
    lazy = false
},

Keybinds/commands

• :Sv: Open the servery ui.
• :[N]Sv[!]: Go to the nth last visited session. Also stops the current session if ! is used.
• :Sv[!] [dir]: Go to the session in [dir], creating it if it's not already open. Also stops the current session if ! is used.
• :[N]SvStop: Close the nth last visited session.
• :SvStop [dir]: Close the session in [dir].

Keymaps should be set up manually:

vim.keymap.set("n", "<c-f>", "<cmd>Sv<cr>", { desc = "Switch nvim sessions" })
vim.keymap.set("n", "ZV", "<cmd>1Sv<cr>", { desc = "Go to previous session" })

Why servery.nvim?

I previously managed sessions with Prime's tmux-sessionizer. Tmux served me well but has some rough edges which I'd prefer to avoid, so once Neovim added :connect and :detach I decided to just move my whole life into Neovim.