mcpField
C
convex-env

convex-env

github.com/get-convexCloud & DevOps6931.3k installsUpdated 1d ago
Repository

About convex-env

convex-env is a skill for Convex developers managing deployment environment variables and secrets. It covers setting and reading values while keeping secrets out of code and version control.

Key features

  1. 01Set variables per deployment
  2. 02Read variables in actions
  3. 03Keep secrets out of commits
  4. 04List variables for verification

Use cases

  1. 01Configure secrets for separate deployments
  2. 02Use environment variables in actions

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/get-convex/agent-skills --skill convex-env

After installing, type/convex-envin Claude Code to confirm it loaded.

Details

From the project README

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 with npx convex env list.

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.

Comments

Markdown supported