# folke/persistence.nvim

💾  Simple session management for Neovim

Repository: https://github.com/folke/persistence.nvim
Canonical: https://ross.abutalabs.com/products/persistencenvim
Language: Lua
License: Apache-2.0
License Family: permissive
Topics: neovim, neovim-plugin
Last push: 2025-10-28T16:08:31+00:00

## Health v2 (maintenance only)
Score: 45/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 49, release rhythm 8, longevity 100
- inputs: {"age_days": 1888, "days_push": 309, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1009, forks 46 (observed 2026-08-28T04:03:12.804114+00:00)

## What it is
A Lua plugin for Neovim that provides automated session management, saving the active session on exit and restoring it on demand. It stores sessions per directory (optionally per git branch) under Neovim's state directory and exposes a simple API and user commands for loading, selecting, or stopping sessions.

## Use cases
- restore my last neovim session when reopening a file
- save open buffers automatically when quitting vim
- keep separate neovim sessions per git branch
- pick a saved session to load in neovim
- resume editing where I left off in neovim
- integrate session restore with a neovim dashboard

## When to choose
- you use Neovim >= 0.7.2 and want lightweight, automatic session persistence
- you want per-directory or per-branch sessions without manual :mksession
- you pair session restore with dashboard/startify-style plugins

## When to avoid
- you use Vim or an older Neovim version
- you need full workspace/session features beyond buffer and window layout saving
- you prefer built-in :mksession workflows

## Facets
- artifact type: plugin
- maturity: active
- function: developer-tools, configuration-management
- domain: developer-tools, text-editors
- platform: editor-plugin, cli
- tags: neovim, session-management, lua, vim-plugin, editor-workflow

## Member repositories
- folke/persistence.nvim (main) score 45

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:12.804114+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T07:12:02.792015+00:00, confidence not recorded.
  - readme: https://github.com/folke/persistence.nvim (fetched 2026-08-28T04:03:12.804114+00:00, sha be47729ce885)
- Data as of 2026-08-30T08:39:29.467469+00:00.