Skip to content
Browse documentation
cli

Project operations

Inspect project settings, find available checks, and follow the supported deployment flow.

Inspect your project

Start with these read-only checks. They inspect your project without installing packages or running application code.

project context [path]Show declared packages, observed installation state, and locally retained release references.
project check [path]Validate project/workspace metadata and local contracts. Does not build or test.
doctor [path]Explain metadata problems and available context. Does not repair files or install tools.
project verify [path]List supported root Bun scripts. Select checks with --task; execute them with --run.
bash
smoothie project context /absolute/my-product --format json
smoothie project check /absolute/my-product --format json
smoothie project verify /absolute/my-product --format json

Terminal commands find standalone projects or declared workspace members. Invalid ancestor metadata stops discovery; MCP uses only its configured root. Missing local references mean context is unavailable, not that the package is absent.

Add project metadata

init creates workspace metadata. project adopt adds project metadata with the name and SDK you specify. Neither command creates a Recipe app or installs packages. See Application structure and Configuration and environment for the manifest format. Recognizing an SDK name does not mean that language has TypeScript's support.

Run checks and deploy

Project scripts are your application's code: the CLI runs them without a sandbox, and a passing script can still skip tests internally. Use finite checks, not a dev server. The runner handles cancellation and same-process-group cleanup; detached services remain your responsibility.

Follow Testing and verification for check selection and the CI guide for automation.

Deployment commands currently support the Smoothie Starter Cloudflare profile. Follow Build and deployment for build plans, OAuth/token setup, explicit deployment, preview, and status checks. A successful upload is not an application-health check.