asyq

Asyq CLI — Environment Variable Scanner & .env Generator with AI

Automatically generate .env.example files by scanning your codebase for environment variable usage.

Installation

npm install -D asyq
# or
pnpm add -D asyq
# or
yarn add -D asyq

Usage

npx asyq init

Choose between two modes:

• Default - Fast generation with variable names only
• AI-assisted - Adds descriptions and example values (requires OpenAI API key)

Commands

Command	Description
npx asyq init	Interactive setup
npx asyq init --force	Overwrite existing files
npx asyq init --monorepo	Generate for each workspace
npx asyq init --debug	Show scan diagnostics

Options

Option	Description
--root <dir>	Project root to scan (default: .)
--out <file>	Output filename (default: .env.example)
--force	Overwrite without confirmation
--include-lowercase	Include mixed-case variables
--debug	Print detailed diagnostics
--monorepo	Generate for root + workspaces

Examples

# Basic usage
npx asyq init

# Force overwrite
npx asyq init --force

# Monorepo project
npx asyq init --monorepo

# Custom output
npx asyq init --out .env.template

# Scan specific directory
npx asyq init --root ./packages/api

Set your OpenAI API key:

export OPENAI_API_KEY=sk-...
npx asyq init

Or enter it when prompted (not saved to disk).