danstrem2 Env Sync
Your .env has 30 variables and nobody knows what half of them do. This tool creates a properly documented .env.example with secrets stripped out.
One command. Zero config. Just works.
Quick Start
npx ai-env-sync
What It Does
- Reads all your .env files (.env, .env.local, .env.development)
- Strips secret values but keeps the keys
- Adds helpful comments explaining each variable
- Generates a clean .env.example
Usage Examples
# Generate .env.example
npx ai-env-sync
# Specify project directory
npx ai-env-sync ./my-project
Best Practices
- Run before committing - keep .env.example in sync
- Add to CI - verify .env.example matches .env structure
- Group related vars - makes it easier to configure
- Document required vs optional - not everything needs a value
When to Use This
- Onboarding new team members
- Setting up CI/CD environments
- Documenting environment requirements
- Keeping .env.example up to date
Part of the LXGIC Dev Toolkit
This is one of 110+ free developer tools built by LXGIC Studios. No paywalls, no sign-ups, no API keys on free tiers. Just tools that work.
Find more:
- GitHub: https://github.com/LXGIC-Studios
- Twitter: https://x.com/lxgicstudios
- Substack: https://lxgicstudios.substack.com
- Website: https://lxgicstudios.com
Requirements
No install needed. Just run with npx. Node.js 18+ recommended. Needs OPENAI_API_KEY environment variable.
npx ai-env-sync --help
How It Works
Reads your .env files, identifies the variables, and uses GPT-4o-mini to generate helpful descriptions for each one. Sensitive values are replaced with placeholder text like "your_api_key_here".
License
MIT. Free forever. Use it however you want.