npx convex runnow supports--inline-queryfor evaluating readonly queries without creating a named function first, for example:npx convex run --inline-query 'await ctx.db.query("messages").take(5)'.- Added
ctx.metato access extra metadata at runtime:ctx.meta.getFunctionMetadata(): the current function's name, component, visibility, and whether it's a query, mutation, or action.ctx.meta.getTransactionMetrics(): how much capacity remains in the current transaction. Only available in queries and mutations.
- Added a
npx convex env defaultcommand for getting and setting default environment variables for a project. npx convex deploynow supports a--messageoption that allows you to write details in the deployment’s audit log. When runningnpx convex deployon CI runners on popular platforms (including GitHub Actions, Vercel, and Netlify), a default message will be provided if you don’t provide one (e.g. “Deployed from GitHub Actions • e83c516”).- When deploying to a preview deployment, you can now reuse the existing deployment
instead of creating a new one by using
--preview-nameinstead of--preview-create. This behavior is also used when deploying to preview deployments from the CI without specifying--preview-createexplictly, but you can specify--preview-createexplicitly to restore the old behavior. When using the--preview-runflag, the function only runs when a new deployment is created. npx convex codegencan now automatically start a local backend when necessary.- You can now increase the timeout used by the CLI when starting a local backend
with
CONVEX_LOCAL_BACKEND_STARTUP_TIMEOUT_SECS; this can be useful when using large local databases. - Fixed a bug where
npx convex ai-files removewould also remove skill files that were not installed bynpx convex ai-files - Fixed a bug where the automatically-generated files would sometimes sort imports in inconsistent order across platforms.
- Fixed a bug in
npx convex dev --startwhere, in some cases, the--startcommand would continue to run after closing the Convex dev server with <kbd>Ctrl+C</kbd>. - Generating APIs via function-spec now supports validators with int64 literals.
convex v1.36.0
Ian Macartney
Published on April 22, 2026
Overview
Included Features (6)
Change the default behavior of preview deployments to re-use rather than creating a new deployment on each build. Allow re-creating by explicitly passing --preview-create
Allow passing a --message to npx convex deploy, and provide defaults from common CI environments
Allow setting and getting default environment variables via npx convex env default get/list/set
Surface the currently executing function's name, component, function type (query/mutation/action) and visibility.
Allow queries and mutations to inspect how much bandwidth has been consumed so far, so they can stop early or observe how much bandwidth sub-transactions took
Support multiple long-lived production and staging deployments per project so teams can segment apps, regions, or customer environments more cleanly.