@itsthw/autoenv

autoEnv generates a .env.example file by scanning your project for real environment variable usage. It creates a single source of truth for your team without guessing secrets.

Installation & Usage

First, install it as a development dependency:

# Using npm
npm install -D @itsthw/autoenv

# Using pnpm
pnpm add -D @itsthw/autoenv

then, run the initialization command:

npx autoenv init

How It Works

• Scan: Analyzes codebase for process.env, import.meta.env, and ${VAR} usage.
• Detect: Identifies only variables that are actually used.
• Generate: Creates a clean .env.example file.

• Default Mode: Lists variable names only.
• AI Mode: Adds descriptions and safe example values using LLMs.

OpenAI API Key Security

If you choose AI Mode, an OpenAI API key is required.

• Input: Reads from the OPENAI_API_KEY environment variable (recommended) or an interactive prompt.
• Safety: The key is never written to disk, never logged, and only used for the current run.

Key Options

Command	Description
npx autoenv init	Standard interactive setup.
npx autoenv init --force	Overwrites existing output files.