Cómo usar
- Copia el comando y revisa el paquete antes de instalarlo en tu entorno de agente.
- Consulta las herramientas, credenciales y entornos necesarios en el documento original.
- Describe las entradas y el resultado deseado; contrasta la salida con las fuentes.
npx skills add https://github.com/convex/agent-skills --skill convex-envAntes de empezar
- La instalación no incluye suscripción al modelo, cuota API ni permisos sobre tus archivos.
- Las estrellas e instalaciones reflejan actividad, no una prueba independiente de calidad o seguridad.
Contenido del repositorio de origen con títulos, ejemplos, código, tablas, enlaces e imágenes preservados.
<!-- GENERATED from convex-agents content/capabilities/env.json — do not edit by hand. -->
Manage env vars + secrets
Store secrets as Convex deployment env vars (npx convex env set), read them in any Convex function through the typed env export, never commit them.
Workflow
- Declare the var in the
envsection ofdefineApp(ordefineComponentfor a component) inconvex.config.ts, e.g.env: { KEY: v.string() }. This generates the typedenvexport. Components don't see the app's env vars, so pass any a component declares through its.use()call, e.g.app.use(myComponent, { env: { KEY: app.env.KEY } }). npx convex env set KEY value(per deployment). For secrets, keep the value out of shell history: omit it to be prompted (npx convex env set KEY) or pipe it in on stdin (e.g.pbpaste | npx convex env set KEY).- Read via
env.KEYfromimport { env } from "./_generated/server"in queries, mutations or actions. Prefer it overprocess.env.KEY. - Never hardcode or commit secrets;
.env.localvalues don't reach Convex functions, so set the dev deployment's value too. - 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.
- Read env vars through the typed
envexport in queries, mutations and actions.process.envremains available as a legacy/fallback path, e.g. for existing or third-party code that expects to read env vars there. - Different deployments need their own values.
- Check what is set with
npx convex env list --names-only; never print secret values into the conversation.