ecolog.nvim
A sophisticated Neovim plugin for managing .env files and environment variables with autocompletion, security features, and monorepo support.
What is ecolog.nvim?
Ecolog.nvim is a Neovim plugin that provides comprehensive environment variable management directly within the editor. It solves the problem of scattered .env files and insecure handling of sensitive variables by offering intelligent autocompletion, type checking, value peeking, and security features like shelter mode for masking sensitive data.
Neovim users who work with environment variables across multiple projects, particularly developers in monorepo setups, those handling sensitive API keys and credentials, and teams needing consistent environment variable management.
Developers choose Ecolog.nvim because it integrates environment variable management directly into their editor workflow with advanced features like language-specific autocompletion, monorepo support, and security masking—replacing multiple separate tools with a single, sophisticated solution.
Overview
The most sophisticated all-in-one toolkit to work with .env files and environment variables in NeoVim
Use Cases
Best For
- Managing environment variables across multiple projects in a monorepo setup
- Securing sensitive API keys and credentials with visual masking during screen sharing
- Getting intelligent autocompletion for environment variables in TypeScript, JavaScript, Python, and other languages
- Working with complex environment variable interpolation and shell-like syntax
- Integrating environment variable management with Telescope, FZF, or Snacks pickers
- Automatically detecting and switching between workspace environments in large codebases
Not Ideal For
- Teams using multiple editors who need a cross-IDE environment variable solution
- Projects with only a few static environment variables where simpler plugins or manual management suffice
- Environments with strict security policies that prohibit shell command substitution in .env files
- Developers who prefer minimal Neovim configurations and are wary of plugin complexity
Pros & Cons
Pros
Automatically detects and manages environment variables across workspaces in monorepos like Turborepo, Nx, and Lerna, with intelligent file resolution and workspace switching, as detailed in the extensive monorepo support section.
Offers shelter mode with configurable masking for sensitive data, including partial masking and per-module controls, providing screen sharing protection and secure handling of credentials like API keys.
Seamlessly integrates with popular Neovim tools like Telescope, FZF, Snacks, LSP, and LSP Saga, enhancing workflows with fuzzy finding, pickers, and hover/definition features.
Provides context-aware completions with type checking for over a dozen languages, supported through nvim-cmp and blink-cmp integrations, with language-specific patterns for accurate variable detection.
Cons
The README warns about a complete rewrite to ecolog2.nvim and recommends using the v1 branch, indicating potential breaking changes and future migration efforts for users.
The LSP integration is labeled as experimental and may interfere with existing LSP setups, requiring caution and possible troubleshooting, as noted in the warnings section.
With numerous options for shelter mode, monorepo support, integrations, and interpolation, the setup can be overwhelming, especially for users with simple environment variable needs.
Frequently Asked Questions
Related Projects
instant.nvimcollaborative editing in Neovim using built-in capabilities
codesnap.nvim📸 Snapshot plugin with rich features that can make pretty code snapshots for Neovim
nvim-biscuitsA neovim port of Assorted Biscuits. Ends up with more supported languages too.
urlview.nvim🔎 Neovim plugin for viewing all the URLs in a buffer
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.