Ship
Back to changelog
Product Release April 22, 2026

convex v1.36.0

convex v1.36.0
IM

Ian Macartney

Published on April 22, 2026

Overview

  • npx convex run now supports --inline-query for 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.meta to 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 default command for getting and setting default environment variables for a project.
  • npx convex deploy now supports a --message option that allows you to write details in the deployment’s audit log. When running npx convex deploy on 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-name instead of --preview-create. This behavior is also used when deploying to preview deployments from the CI without specifying --preview-create explictly, but you can specify --preview-create explicitly to restore the old behavior. When using the --preview-run flag, the function only runs when a new deployment is created.
  • npx convex codegen can now automatically start a local backend when necessary.
  • You can now increase the timeout used by the CLI when starting a local backend with CONVEXLOCALBACKENDSTARTUPTIMEOUT_SECS; this can be useful when using large local databases.
  • Fixed a bug where npx convex ai-files remove would also remove skill files that were not installed by npx 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 --start where, in some cases, the --start command 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.

Included Features (6)