Environment doctor

About

Reconciles the environment variables the code reads with the ones your example file, CI and deploy config actually set.

Files in v1.0.0

• replicamd.plugin.json2224 B
• skills/config-that-explains-itself.md2286 B

Contributes

{
  "commands": [
    {
      "id": "check",
      "title": "Check environment and config drift",
      "prompt": "Reconcile this project's configuration across everywhere it is declared.\n\nBuild the list of variables the code actually reads - every `process.env.X`, `import.meta.env.X`, `os.environ[...]`, `Deno.env.get` or equivalent, including ones read through a config module. Then read what the project promises: the example env file, the README setup section, the CI workflow env blocks, the container and compose files, and any deploy manifest in the repo.\n\nReport four lists:\n1. **Read but never documented** - the ones a new contributor will not know to set. These are the ones that waste a first day.\n2. **Documented but never read** - dead config that should be deleted.\n3. **Set in CI but missing locally**, and the reverse.\n4. **Anything that looks like a real secret checked into the repo**, with the file and line. Flag these first regardless of the rest.\n\nFor each variable in list 1, say what breaks when it is missing: a crash at boot is fine, silent wrong behaviour is a bug worth fixing on its own."
    },
    {
      "id": "example",
      "title": "Regenerate the example env file",
      "prompt": "Rewrite the project's example env file so it matches what the code reads today.\n\nGroup by concern, keep the existing ordering where it already made sense, and give each variable a one-line comment saying what it does and what happens if it is absent. Use obviously fake placeholder values - never a real key, and never a value that would work by accident.\n\nMark which are required to boot and which are optional, and say what the optional ones turn off. Do not include anything the code does not read."
    }
  ],
  "skills": [
    "skills/config-that-explains-itself.md"
  ]
}

Versions

• v1.0.07/26/2026 · 2 files

Install

Nothing happened? ReplicaMD may not be installed yet - or open it first, then Settings → Plugins and install by id.

Plugin id:

Bundle endpoint: