$ show coffebar/neovim-project
The Neovim project manager plugin is a Lua-based Neovim plugin designed to streamline project workflow by maintaining a history of visited projects and enabling quick restoration of Neovim sessions (including UI state like neo-tree expanded directories) upon switching projects. It integrates with popular fuzzy finders (telescope, fzf-lua, snacks) for project selection and supports optional per-branch session management for Git repositories. The architecture is modular, separating concerns into distinct modules: configuration handling, project lifecycle management, history persistence, path and glob pattern resolution, Git integration, and session-specific payload storage (for neo-tree state). The plugin leverages Neovim's autocommands to synchronize session saving/loading with project switches and Git branch changes, ensuring a seamless user experience. Key strengths include robust glob pattern handling (with correct support for **, *, ?, and character classes), a self-healing history mechanism that automatically reloads when the history file is modified externally, and thoughtful integration with Neo-tree to restore UI state. The plugin demonstrates attention to detail in edge cases, such as handling symlinks in project paths and detecting Git worktrees.
The LLM identified 3 files worth highlighting for reuse:
This module provides robust glob pattern to Lua pattern conversion, path resolution (including symlink handling), and project discovery from glob patterns. It includes sophisticated handling of edge cases like ** patterns, hidden files, and path separators. The wildcard_to_pattern function demonstrates non-obvious skill in correctly converting glob patterns to Lua patterns while respecting nuances like not matching dot-files with a single * unless the pattern starts with a dot.
This module manages a persistent history of projects (or any string list) stored in a file, with automatic reloading when the file is changed externally (e.g., via sync tools). It uses neovim's vim.loop for efficient file watching and implements atomic writes to avoid corruption. The module is self-contained and could be adapted for any history-tracking need in a Neovim plugin.
This module provides essential Git utilities for Neovim plugins: checking Git availability, getting the current branch for a directory, resolving the path to the HEAD file (handling regular repos and worktrees), and sanitizing branch names for safe use in filenames. It caches the Git availability check and is self-contained, requiring only Neovim's built-in functions.