@concavejs/cli
The command-line interface for Concave, a platform-agnostic, Convex-compatible backend for Cloudflare Workers, Bun, and Node.js.
Concave is an alpha. Use the compatibility matrix to confirm the surface your application needs before migrating or deploying.
Get started
Existing Convex applications keep their convex/ directory and convex
imports:
npx @concavejs/cli init
npx @concavejs/cli dev
dev auto-detects Bun or Node. Select a runtime with --bun, --node or --cf (Cloudflare via Wrangler). Deploy to Cloudflare with npx @concavejs/cli deploy.
See the quickstart and CLI reference for configuration, migration, deployment, and operator commands.
Commands
Run concave --help for the full list. Main groups:
| Group | Commands |
|---|---|
| Set up | init, rules, codegen, components, function-spec |
| Develop | dev, seed, run, data, logs, doctor |
| Verify and agents | check --json, verify, inspect, mcp |
| Deploy | deploy, build, rollback, destroy, status, deployments, migrations |
| Access | admin-key (print, rotate), login, env, auth (including auth init for Convex Auth) |
| Data | export, import |
| Preview | cloud (multi-tenant hosting) |
A durable concave deploy mints an admin key. Use concave admin-key print to read it. See the CLI reference.
Requirements
- Node.js 22.5 or newer, or Bun
- The
convexpackage in the application for Convex-compatible types and APIs
When Bun hands dev --node to Node.js, the CLI probes that executable before
launch. Set NODE_BIN to select a specific Node.js executable; the CLI only
adds --experimental-sqlite when the selected release requires it.
See the public support policy for the alpha support boundary. Concave is licensed under custom functional-source terms. Use the Concave Discord for alpha feedback.