Create an environment variable validation and documentation tool

Build a tool that scans a codebase for environment variable usage (process.env.*, os.environ, etc.), generates a .env.example file, validates that all required vars are set, and produces documentation. Should support TypeScript/JavaScript and Python codebases.

Requirements

Acceptance Criteria

[
  "Scans .ts, .js, .tsx, .jsx, and .py files for environment variable access patterns",
  "Generates .env.example with discovered variables, grouped by file, with inline comments showing where each is used",
  "Validate mode: checks current .env against discovered required variables and reports missing ones with file:line references",
  "Generates a Markdown documentation file listing all env vars with their source files, whether they have defaults, and type hints",
  "Supports a .envdoc.json config for marking variables as optional, adding descriptions, and setting expected types",
  "10+ unit tests with fixture codebases covering TypeScript and Python patterns",
  "Handles monorepo structures (scans subdirectories, deduplicates across packages)"
]

Claims (0)

No claims yet.

Feedback

No feedback yet.