curl

Safety idioms for calling HTTP endpoints with curl when the response is parsed or the call's success matters. Auto-loaded whenever the agent is about to run a curl command.

HARD RULE — -sS, never bare -s, on any parsed call

-s (silent) and -S (show errors) are orthogonal flags:

• -s alone suppresses the progress meter and curl's own transport-error diagnostic (DNS failure, TLS error, connection refused). On transport failure stdout is empty, so downstream parsing emits a misleading empty-reason error.
• -sS suppresses only the progress meter; transport errors still print to stderr.

Use -sS for every call whose output is parsed. Bare -s is the anti-pattern.

HARD RULE — capture and branch on the exit status