mcpField
C
convex-env

convex-env

github.com/convexCloud & DevOps6937.1k installsUpdated 1d ago
Repository

About convex-env

convex-env is a skill for managing secrets as Convex deployment environment variables. It covers setting values per deployment, accessing them from actions, and checking configured names without exposing secret values.

Key features

  1. 01Sets environment variables per deployment
  2. 02Reads values through process.env in actions
  3. 03Lists configured names without secret values
  4. 04Keeps secrets out of code and git

Use cases

  1. 01Storing credentials for a Convex deployment
  2. 02Accessing secrets from actions
  3. 03Checking configured variable names safely

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/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 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.

Comments

Markdown supported