Session Lens extends auto-session through Telescope.nvim, creating a simple session switcher with fuzzy finding capabilities.
![]()
You can call the switcher from telescope
:Telescope session-lens search_session
Or straight from the plugin's path with lua
:lua require('session-lens').search_session()Any plugin manager should do.
Plug
" Plugin dependencies Plug 'nvim-telescope/telescope.nvim' Plug 'rmagatti/auto-session' Plug 'rmagatti/session-lens'See https://github.com/nvim-telescope/telescope.nvim for it's dependencies
Packer
use { 'rmagatti/session-lens', requires = {'rmagatti/auto-session', 'nvim-telescope/telescope.nvim'}, config = function() require('session-lens').setup({--[[your custom config--]]}) end }The plugin is lazy loaded when calling it for the first time but you can pre-load it with Telescope like this if you'd rather have autocomplete for it off the bat.
require("telescope").load_extension("session-lens")Options can be set by calling the setup function, a common option is changing the shorten path behaviour.
require('session-lens').setup { path_display={'shorten'}, }Another example would be changing how the dropdown looks, this can be done by setting the
theme
andtheme_conf
in the setup options. The options intheme_conf
get passed intorequire('telescope.themes').get_dropdown(theme_conf)
, so anything supported byget_dropdown
(or the function that corresponds to the specifiedtheme
) can be used here as well.require('session-lens').setup { path_display = {'shorten'}, theme = 'ivy', -- default is dropdown theme_conf = { border = false }, previewer = true }In addition to the above configs, since everything gets passed into
telescope.builtin.find_files
, any configs passed to thesetup
if supported byfind_files
will override the default behaviour, for example:require('session-lens').setup { prompt_title = 'YEAH SESSIONS', }Session Lens exposes one command
:SearchSession
triggers the customized session pickerNeovim > 0.5
Tested with:
NVIM v0.5.0-dev+a1ec36f Build type: Release LuaJIT 2.1.0-beta3
CARVIEW |
Select Language
HTTP/2 200
date: Wed, 23 Jul 2025 15:02:48 GMT
content-type: text/html; charset=utf-8
vary: X-PJAX, X-PJAX-Container, Turbo-Visit, Turbo-Frame, X-Requested-With,Accept-Encoding, Accept, X-Requested-With
etag: W/"853f006f5e22f52ffcba7db183d0b1e1"
cache-control: max-age=0, private, must-revalidate
strict-transport-security: max-age=31536000; includeSubdomains; preload
x-frame-options: deny
x-content-type-options: nosniff
x-xss-protection: 0
referrer-policy: no-referrer-when-downgrade
content-security-policy: default-src 'none'; base-uri 'self'; child-src github.githubassets.com github.com/assets-cdn/worker/ github.com/assets/ gist.github.com/assets-cdn/worker/; connect-src 'self' uploads.github.com www.githubstatus.com collector.github.com raw.githubusercontent.com api.github.com github-cloud.s3.amazonaws.com github-production-repository-file-5c1aeb.s3.amazonaws.com github-production-upload-manifest-file-7fdce7.s3.amazonaws.com github-production-user-asset-6210df.s3.amazonaws.com *.rel.tunnels.api.visualstudio.com wss://*.rel.tunnels.api.visualstudio.com objects-origin.githubusercontent.com copilot-proxy.githubusercontent.com proxy.individual.githubcopilot.com proxy.business.githubcopilot.com proxy.enterprise.githubcopilot.com *.actions.githubusercontent.com wss://*.actions.githubusercontent.com productionresultssa0.blob.core.windows.net/ productionresultssa1.blob.core.windows.net/ productionresultssa2.blob.core.windows.net/ productionresultssa3.blob.core.windows.net/ productionresultssa4.blob.core.windows.net/ productionresultssa5.blob.core.windows.net/ productionresultssa6.blob.core.windows.net/ productionresultssa7.blob.core.windows.net/ productionresultssa8.blob.core.windows.net/ productionresultssa9.blob.core.windows.net/ productionresultssa10.blob.core.windows.net/ productionresultssa11.blob.core.windows.net/ productionresultssa12.blob.core.windows.net/ productionresultssa13.blob.core.windows.net/ productionresultssa14.blob.core.windows.net/ productionresultssa15.blob.core.windows.net/ productionresultssa16.blob.core.windows.net/ productionresultssa17.blob.core.windows.net/ productionresultssa18.blob.core.windows.net/ productionresultssa19.blob.core.windows.net/ github-production-repository-image-32fea6.s3.amazonaws.com github-production-release-asset-2e65be.s3.amazonaws.com insights.github.com wss://alive.github.com api.githubcopilot.com api.individual.githubcopilot.com api.business.githubcopilot.com api.enterprise.githubcopilot.com; font-src github.githubassets.com; form-action 'self' github.com gist.github.com copilot-workspace.githubnext.com objects-origin.githubusercontent.com; frame-ancestors 'none'; frame-src viewscreen.githubusercontent.com notebooks.githubusercontent.com; img-src 'self' data: blob: github.githubassets.com media.githubusercontent.com camo.githubusercontent.com identicons.github.com avatars.githubusercontent.com private-avatars.githubusercontent.com github-cloud.s3.amazonaws.com objects.githubusercontent.com release-assets.githubusercontent.com secured-user-images.githubusercontent.com/ user-images.githubusercontent.com/ private-user-images.githubusercontent.com opengraph.githubassets.com copilotprodattachments.blob.core.windows.net/github-production-copilot-attachments/ github-production-user-asset-6210df.s3.amazonaws.com customer-stories-feed.github.com spotlights-feed.github.com objects-origin.githubusercontent.com *.githubusercontent.com; manifest-src 'self'; media-src github.com user-images.githubusercontent.com/ secured-user-images.githubusercontent.com/ private-user-images.githubusercontent.com github-production-user-asset-6210df.s3.amazonaws.com gist.github.com; script-src github.githubassets.com; style-src 'unsafe-inline' github.githubassets.com; upgrade-insecure-requests; worker-src github.githubassets.com github.com/assets-cdn/worker/ github.com/assets/ gist.github.com/assets-cdn/worker/
server: github.com
content-encoding: gzip
accept-ranges: bytes
set-cookie: _gh_sess=hqWCmpUFnyCzTsE8tvhII2trFFGf5z%2B9KmaWQd8rCRWABOjW%2F0YdAS5DyHKIvy3rNjKSX%2BmqzTBbEGcN2hz2X2UadMWqyNRROFuCT3%2BxF%2FQZibvXQ8C8sN9I2gjY9mImqkcdoKGl8yjtdki7Xw11MpltuwIXrBIDGe0WshUamNhyjufGuYN7DPQ%2BGTg01%2FTAT7U4J3dNVV6GMg2Z4%2BLnXwhlec6fxksG23CQqKNN4d7O%2Fmp8DB08W0%2BMKMDgsAhs6lPk8A97%2BbY1BBh8wBrhqQ%3D%3D--MuR%2Fa5V%2FH3T0pWgO--aSpIK6vpUl0LMBihyvkO8g%3D%3D; Path=/; HttpOnly; Secure; SameSite=Lax
set-cookie: _octo=GH1.1.1385384316.1753282967; Path=/; Domain=github.com; Expires=Thu, 23 Jul 2026 15:02:47 GMT; Secure; SameSite=Lax
set-cookie: logged_in=no; Path=/; Domain=github.com; Expires=Thu, 23 Jul 2026 15:02:47 GMT; HttpOnly; Secure; SameSite=Lax
x-github-request-id: 8F26:2FAFD7:D9AA82:1017F0C:6880F997
GitHub - rmagatti/session-lens: A session-switcher extension for rmagatti/auto-session using Telescope.nvim
Skip to content
Navigation Menu
{{ message }}
-
-
Notifications
You must be signed in to change notification settings - Fork 14
A session-switcher extension for rmagatti/auto-session using Telescope.nvim
License
rmagatti/session-lens
Folders and files
Name | Name | Last commit message | Last commit date | |
---|---|---|---|---|
Repository files navigation
About
A session-switcher extension for rmagatti/auto-session using Telescope.nvim
Topics
Resources
License
Stars
Watchers
Forks
Releases
No releases published
Sponsor this project
Packages 0
No packages published
You can’t perform that action at this time.