/install jrv-env-doctor
Env Doctor
Validate and audit .env files for secrets, duplicates, syntax issues, and missing variables.
Quick Start
python3 scripts/env_doctor.py .env
python3 scripts/env_doctor.py .env --example .env.example
python3 scripts/env_doctor.py .env --strict --json
Features
- Secret scanning — detects AWS keys, GitHub tokens, Stripe keys, Slack tokens, Google API keys, JWTs, private key blocks, and more
- Duplicate detection — flags variables defined more than once
- Example comparison — compares .env against .env.example to find missing or extra vars
- Syntax validation — catches malformed lines, unquoted values with spaces
- Placeholder detection — warns about values like "changeme", "your-api-key-here"
- Exit codes — 0 = healthy, 1 = issues, 2 = secret leaks (CI-friendly)
- No dependencies — Python stdlib only
Options
| Flag | Description |
|---|---|
--example PATH |
.env.example file for comparison |
--json |
Output structured JSON |
--strict |
Treat empty values as errors |
Secret Patterns Detected
AWS Access/Secret Keys, GitHub Tokens (ghp_, gho_, ghs_, ghu_, github_pat_), Slack Tokens, Stripe Keys, Google API Keys, Private Key Blocks, JWTs, Twilio Tokens, SendGrid Keys, Heroku API Keys, and generic high-entropy secrets.
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install jrv-env-doctor - After installation, invoke the skill by name or use
/jrv-env-doctor - Provide required inputs per the skill's parameter spec and get structured output
What is Env Doctor?
Validate .env files for common issues — detect leaked secrets (AWS keys, GitHub tokens, Stripe keys, JWTs), find duplicate variables, flag empty values, comp... It is an AI Agent Skill for Claude Code / OpenClaw, with 284 downloads so far.
How do I install Env Doctor?
Run "/install jrv-env-doctor" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Env Doctor free?
Yes, Env Doctor is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Env Doctor support?
Env Doctor is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Env Doctor?
It is built and maintained by John Wang (@johnnywang2001); the current version is v1.0.0.