Skip to content

convex-env

Set and wire Convex deployment env vars / secrets for the app.

32,797
installs
0 up / 0 down, score 0.00
votes
66
repo stars
Updated
less than a month ago
In the catalog since
30 Sept 2026
From
get-convex/agent-skills
DevOps & Cloud
Get it through your agent npx skills add get-convex/agent-skills@convex-env

Skill instructions

Rendered from the published SKILL.md, 20 lines.

Manage env vars + secrets

Store secrets as Convex deployment env vars (npx convex env set), read them with process.env in actions, never commit them.

Workflow

  1. npx convex env set KEY value (per deployment).
  2. Read via process.env.KEY inside actions (not queries/mutations).
  3. Never hardcode or commit secrets; add to .env.local only for local.
  4. Confirm it's set with npx convex env list --names-only, which lists names without printing the secret values.

Rules

  • Secrets live in Convex env vars, never in code or git.
  • process.env only in actions ('use node' if needed), not queries/mutations.
  • Different deployments need their own values.
  • Check what is set with npx convex env list --names-only; never print secret values into the conversation.