Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Commands

The current CLI has one subcommand: uzumibi new.

uzumibi new

uzumibi new [OPTIONS] --template <TEMPLATE> <PROJECT_NAME>

Arguments and options

Argument or optionDescription
<PROJECT_NAME>Project name used in generated files and, by default, as the destination directory
-t, --template <TEMPLATE>Required template name
-d, --dest-dir <DEST_DIR>Write to a directory other than PROJECT_NAME
--forceOverwrite existing files without prompting
--features <FEATURES>Comma-separated feature overlays

Available templates are cloudflare, cloudrun, fastly, spin, serviceworker, and webworker.

Currently defined feature overlays are:

TemplateFeaturePurpose
cloudflareenable-externalAsync Cloudflare host APIs from Ruby
cloudflarequeueCloudflare Queues consumer; includes external APIs
cloudrunenable-externalGoogle Cloud external-service APIs
cloudrunqueuePub/Sub push consumer

Examples

uzumibi new --template cloudflare my-worker
uzumibi new -t cloudflare --features enable-external my-worker
uzumibi new -t cloudflare --features queue queue-consumer
uzumibi new -t cloudflare --dest-dir ./apps/worker my-worker

When files already exist and --force is not supplied, the CLI shows a diff and prompts for each conflicting file.

Help and version

uzumibi --help
uzumibi new --help
uzumibi --version