envcurl

envcurl is a thin wrapper around curl that expands {{VAR}} placeholders in every argument before invoking curl.

envcurl -H "Authorization: Bearer {{API_KEY}}" \
        -d '{"token":"{{TOKEN}}","region":"{{REGION:-us-east-1}}"}' \
        https://{{API_HOST}}/v1/register

Installation

Run it directly with npx:

npx envcurl https://{{API_HOST}}/health

Or install it globally after publishing:

npm install -g envcurl

Variable syntax

Supported patterns:

• {{VAR}}: use VAR; error if it is missing
• {{VAR:-default}}: use VAR if set, otherwise use default
• \{{VAR}}: escape the placeholder and pass the literal {{VAR}}

Variable sources

Variables are resolved in this order, with later sources overriding earlier ones:

1. Process environment
2. .env in the current working directory, if present
3. Explicit --env-file values, in the order provided, where the last file wins

Examples:

envcurl --env-file .env.production \
        -H "Authorization: Bearer {{API_KEY}}" \
        https://api.example.com/deploy

envcurl --env-file .env --env-file .env.production \
        -H "Authorization: Bearer {{API_KEY}}" \
        https://api.example.com/deploy

Flags

| Flag | Description | |---|---| | --env-file <path> | Load variables from a specific env file. Repeatable; last file wins for duplicate keys. | | --expand-stdin | Expand {{VAR}} placeholders in stdin before forwarding to curl. Off by default. |

All other arguments are passed through to curl after variable expansion.

Contributing

Maintainer instructions for testing, packaging, and release flow are in CONTRIBUTING.md.