Convex 1.33.0 – Smarter CLI, agent-friendly init

Overview

Convex 1.33.0 brings major improvements to the CLI developer experience.

npx convex env set now accepts values interactively, via --from-file, or multiple variables at once via stdin. Pair it with npx convex env list to round-trip environment variables between deployments.

Both npx convex env set and npx convex run now auto-start a local backend when needed — no more forgetting to run npx convex dev first.

npx convex init now supports agent workflows via CONVEX_AGENT_MODE=anonymous, enabling fully non-interactive deployment setup.

Also includes: improved --env-file reliability, better generated API types to avoid infinite recursion, getConvexSize returning 0 for undefined, and no longer overwriting tsconfig.json/README.md when configuring a new deployment.

Included Features (3)

#260

Improved convex env workflow

npx convex env set now accepts values interactively, via --from-file, or multiple variables at once via stdin (e.g. npx convex env set < .env.defaults). npx convex env list emits a robust format for multi-line variables, enabling round-tripping between deployments with npx convex env list > .env.convex and npx convex env set < .env.convex.

Completed

View full item details

#261

Auto-start local backend for CLI commands

npx convex env set and npx convex run will now auto-start a local backend if one is not already running, so you no longer need to manually start npx convex dev before running CLI commands.

Completed

View full item details

#262

Agent-friendly deployment initialization

npx convex init now supports non-interactive agent workflows via CONVEXAGENTMODE=anonymous. Combined with npx convex env set, agents can fully initialize deployments and configure environment variables without human interaction.

Completed

View full item details