Packages & CLI Tools

This section documents individual @cogs/* packages and the command-line tools they ship — as opposed to the Skills Catalog, which documents the Claude Code skills built on top of some of these packages. Start here if you want to run a cogs CLI tool directly, outside of Claude Code.

Tool	Package	What it's for
cogs-env-doctor	@cogs/env-doctor (private, never published)	Diagnoses and fixes quote-wrapped secret values on Render environment variables
config-lint	@cogs/config (public)	Lints an app's layered .env* chain for the same quote-wrapping mistake, at the source, before it ever reaches a deploy provider

Both tools exist because of the same underlying bug: a value copy-pasted verbatim out of a shell-quoted .env file — FOO='abc123' — loses its meaning once it lands somewhere with no shell to strip the quotes. config-lint catches it locally, in the .env* files themselves, before a deploy. cogs-env-doctor catches (and, cautiously, fixes) it after the fact, directly on a Render service's stored environment variables.

This section will grow as more @cogs/* packages ship their own CLI entry points or warrant a dedicated usage page beyond their package README.