Skip to content

Repository files navigation

🧠 envdoc-ai v1.1.0

The "Shared Brain" for your environment variables.

npm version License: MIT

Tired of cryptic .env.example files? envdoc-ai is a community-powered CLI tool that automatically scans your environment variables and generates beautiful, categorized Markdown documentation.

Built for the modern developer, it transforms chaos into clarity in seconds.

✨ Features

  • 🧠 The Shared Brain: Every description generated by AI is stored in our global database. If someone else has documented a variable, you get their knowledge instantly.
  • 🚀 Zero Config: Just run one command. No configuration, no API keys, no hassle.
  • 📂 Smart Categorization: Automatically groups your variables into logical sections like Auth, Database, API Services, and more.
  • 🤖 AI-Powered Inference: Uses Gemini 1.5 Flash to intelligently guess the purpose of your custom internal variables.
  • 🌐 Explorer View: Browse {stats.total}+ learned variables in our Live Explorer.

📦 Quick Start

Document your project instantly without installation:

npx envdoc-ai

Options

Flag Description
-i, --input <file> Path to your .env.example file (default: .env.example)
-o, --output <file> Output Markdown file path (default: ENV.md)
--readme Append the documentation directly to your README.md
--no-ai Disable the Shared Brain and use only local dictionary
--project-name <name> Custom project name for the documentation header

🛠️ How it Works

  1. Scan: Parses your .env.example file for keys and default values.
  2. Consult: Checks the Shared Brain (our global MongoDB database) for existing descriptions.
  3. Generate: If the variable is new, our AI service describes it and shares the knowledge back to the community.
  4. Format: Produces a premium, categorized Markdown table ready for your docs.

🎨 Premium UI

Try the transformation yourself in our Interactive Playground.


Built with ❤️ by mohitbuilds. Join the community and help document the world's variables!

About

envdoc-ai is a hybrid documentation engine that scans your project's environment variables and automatically generates detailed descriptions, types, and examples using a built-in expert dictionary and Gemini AI fallbacks.

Topics

Resources

Security policy

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages