Skip to content

Top-level commands

Commands that hang off the root rather than a group.

typecheck and bundle the project in the current directory, writing .cow/build (local: no API call)

cow build [options]

push the project when it changed, then make that release the environment’s current code

cow deploy [options]

Options

Flag Description
--release <id> deploy this existing release instead of pushing the working tree

watch the project, build, push, and deploy to development on every save, and tail what the journeys did

cow dev [options]

Options

Flag Description
--no-tail skip the execution and delivery tail

create a cow project: cow.json, journeys/, emails/, and the files to build them

cow init [options] [dir]

Arguments

Argument Description
dir directory to create the project in (default: here)

Options

Flag Description
--org <id> organization id (default: the logged-in org)
--yes accept the defaults instead of prompting
--example <name> start from a gallery example

authenticate via the dashboard browser flow (or –token) and cache the session token

cow login [options]

Options

Flag Description
--token <jwt> paste a Clerk session token instead of the browser flow
--web <url> dashboard URL (default http://localhost:5273)
--no-open do not open the browser; print the URL and wait (headless/agent use)

delete the cached session token

cow logout [options]

restore the project’s source files from a release into the current directory

cow pull [options]

Options

Flag Description
--release <id> the release to restore (default: the latest ready one, or what –env runs)
--force extract even when the git working tree is dirty

build the project, upload it, and create a release the server compiles

cow push [options]

Options

Flag Description
--force push even when nothing changed since the last release

redeploy the release the environment ran before its current one

cow rollback [options]

run a journey against a JSON scenario on a virtual clock (local: no API call, nothing sent)

cow test [options] <journey>

Options

Flag Description
--scenario <file> path to the JSON scenario file

show which credential commands will use, and for a session its subject, org, role, and expiry

cow whoami [options]