Reference · @presolve/cli

CLI

Use the project-local Presolve CLI through pnpm. This keeps the framework, compiler wrapper, native binary, tooling queries, and artifact schemas on one release train.

Application workflow

CommandPurpose

pnpm devCompile, publish, watch, and serve the conventional application.

pnpm checkValidate TypeScript and compiler-admitted application semantics.

pnpm buildCreate the complete production publication under dist/.

pnpm deploy:prepareValidate the Cloudflare provider projection without uploading it.

pnpm deployRevalidate and publish through the configured provider adapter.

Understand a project

pnpm exec presolve explain app/routes/index.tsxpnpm exec presolve explain app/routes/index.tsx --format jsonpnpm exec presolve explain --capabilities --format humanpnpm exec presolve versionpnpm exec presolve help

explain projects source-level compiler facts and the canonical capability registry. Prefer its machine-readable output for editor and CI integrations.

Compiler and tooling commands

Command familyUse

environment --fileGenerate an explicit schema-v1 environment manifest without ambient reads.

explain · inspect · graphProject compiler identity, provenance, ownership, references, route graph, and artifacts.

workspace · watch · cache · cleanOperate explicit compiler workspaces, incremental observations, and caller-owned caches.

trace · profileInspect deterministic compiler execution products without becoming application configuration.

parse · template · html · manifestLow-level hermetic integration commands; ordinary applications normally use conventional check/build.

application · routeExplicit application-publication and route-graph integration surfaces.

migrateReport capability migration status. Policy is report-only; it does not rewrite source.

Reserved command names

The native beta command vocabulary reserves create, benchmark, and doctor, but no canonical compiler product adapter is available for those native commands. pnpm create presolve is a separate published scaffolder; do not substitute presolve create.

Trust the installed help

Low-level flags are contract-specific and can differ from ergonomic application commands. Run pnpm exec presolve help and the relevant subcommand help from the pinned project release.

Environment-aware checks

pnpm exec presolve environment --file .env.production > environment.manifest.jsonpnpm exec presolve check --environment-manifest environment.manifest.jsonpnpm exec presolve build --environment-manifest environment.manifest.json

Workspace, graph, trace, profile, and artifact inspection are compiler integration products. They must not become a second source of application semantics.

Continue to diagnostics →