Convex Env
Use this when you need to get secrets like API keys into a Convex app without leaking them into code or git. It walks through storing values with `npx convex env set` per deployment, reading them via `process.env` inside actions rather than queries or mutations, and checking what's configured with `npx convex env list --names-only`, which shows names without exposing values. The best part is that last check: it keeps secret values out of the conversation itself. The one thing to watch is that each deployment (dev, prod) needs its own values, so it's easy to set a key in dev and wonder why production is failing.
- skills.sh installs
- 41.2K
- GitHub stars
- 69
- last updated
- Oct 26, 2026
Install
$ npx -y skills add convex/agent-skills --skill convex-env --agent claude-codeInstalls into .claude/skills of the current project.
Files
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
npx convex env set KEY value(per deployment).- Read via process.env.KEY inside actions (not queries/mutations).
- Never hardcode or commit secrets; add to .env.local only for local.
- 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.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageDetails
- Repository
- github.com/convex/agent-skills
- Categories
- AI & Agent Building, Databases
- First seen
- Oct 26, 2026
More from convex/agent-skills
All 30- Convex Optimize41.2K
- Convex Crons41.2K
- Convex Advisor41.1K
- Convex Test41.1K
- Convex Agent41.1K
- Convex Add41.1K
- Convex Cost41.1K
- Convex Migrate Rehearse41.1K
- Convex Launch Readiness41K
- Convex Explain App41K
- Convex Backup41K
- Convex Insights41K
- Convex Verify41K
- Convex Domains41K
- Convex Billing41K
- Convex Monitor41K
- Convex Improve Convex Plugin41K
- Convex Seed41K
- Convex Self Heal41K
- Convex Suggest41K
- Convex Sentinel40.9K
- Convex Expert41.4K
- Convex Auth41.4K
- Convex Authz41.3K
Recommended
More AI & Agent Building
convex-optimizeconvex/agent-skillsAudit and optimize an existing Convex app: security, scale, upgrades, observability.41.2Kskills.sh installsconvex-cronsconvex/agent-skillsAdd recurring scheduled jobs (crons) to the Convex app.41.2Kskills.sh installsconvex-testconvex/agent-skillsGenerate convex-test tests for the app's Convex functions.41.1Kskills.sh installsconvex-addconvex/agent-skillsAdd a capability to the CURRENT Convex app — consults the served Convex capability catalog for always-current procedures (billing, crons, auth, agent, search, …41.1Kskills.sh installsconvex-costconvex/agent-skillsPreview Convex spend — rank functions by bytes/documents-read × call-volume from insights, project each cost driver's growth curve, name the cheapest fix; confi41.1Kskills.sh installsconvex-migrate-rehearseconvex/agent-skillsRehearse a live-app schema change + backfill on a snapshot-seeded preview deployment, verify, then promote the proven change to prod with the snapshot as rollba41.1Kskills.sh installs