Question 1

How do I set up projections.nvim to automatically restore my last session?

Accepted Answer

You need to configure an autocmd on VimEnter that checks if you're in a project root and restores the session, or restores the latest session otherwise. The README provides a recipe for this, but it requires manual Lua configuration and doesn't come enabled by default.

Question 2

projections.nvim vs telescope-project.nvim: which is better?

Accepted Answer

projections.nvim offers integrated session management and workspace concepts, while telescope-project.nvim is more focused on project switching with Telescope. Choose projections.nvim if you need sessions and structured workspaces; otherwise, telescope-project.nvim might be simpler for basic project navigation.

Question 3

Can I use projections.nvim without Telescope?

Accepted Answer

Yes, but usability is limited as the Telescope extension is the primary interface. You can build your own switcher using the exposed API, but it requires more effort, and an unofficial fzf-lua extension is available as mentioned in the README.

Question 4

How to add a new workspace dynamically in projections.nvim?

Accepted Answer

You can create a user command using the Workspace.add function, which adds the current directory to a JSON file. The README includes an example configuration for this, allowing flexible workspace management without restarting Neovim.

Question 5

Does projections.nvim save sessions automatically on exit?

Accepted Answer

By default, no. You need to set up an autocmd for VimLeavePre to store the session. The recommended configuration in the README shows how to do this, but it's not enabled out of the box, requiring manual setup.

Question 6

How to handle nvim-tree compatibility with projections.nvim sessions?

Accepted Answer

You must add a pre-store hook to close nvim-tree before saving the session. The README provides a Lua snippet example for this, but you are responsible for implementing similar hooks for other incompatible plugins, as there's no built-in support.

projections.nvim

What is projections.nvim?

Overview

Use Cases

Best For

Related Projects

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions