CLI Reference

The resuma command scaffolds projects, runs dev servers, builds releases, and generates route registries.

TRY IT

CLI commands

resuma new
resuma dev
resuma routes --generate

Install

cargo install resuma

# From monorepo source:
cargo install --path crates/resuma --features cli

resuma new / resuma create

Run resuma new without arguments in a terminal to pick the project name and template interactively.

resuma new                              # interactive prompts
resuma new my-app
resuma new my-app --template basic          # static SSR (default)
resuma new my-app --template todo           # full showcase
resuma new my-app --template flow           # file-based pages
resuma new my-app --template flow-booking   # appointments + query loaders
resuma new my-app --template flow-fullstack # Flow + SQLx sample
resuma new my-app --template production     # Dockerfile + fly.toml + security stub

resuma add

resuma add              # interactive menu
resuma add sqlx    # src/db.rs, migrations/, deps
resuma add turso  # src/turso.rs, .env.example

resuma install skill

Install the Resuma agent skill for Cursor, Codex, or project-local .cursor/skills/. See AI assistant guide.

resuma install skill                 # ~/.cursor/skills/resuma/
resuma install skill --project       # .cursor/skills/resuma/
resuma install skill --target agents # ~/.agents/skills/resuma/
resuma install skill --target all
resuma install skill --list
resuma install skill --force

resuma update

Bump resuma and resuma-macros in the current project, or reinstall the global CLI.

resuma update              # align project deps with CLI version
resuma update --check      # show versions, no changes
resuma update --cli          # cargo install resuma --force
resuma update --version 1.0.2  # pin a specific release

resuma doctor

Quick check for Rust toolchain, cargo-watch, CLI version, and project Cargo.toml setup.

resuma doctor

resuma dev

Starts the app with hot reload. Installs cargo-watch automatically if missing. Saves to src/ or Cargo.toml trigger a rebuild; the browser refreshes when the dev server comes back.

resuma dev
resuma dev --open
resuma dev --addr 0.0.0.0:8080
resuma dev --kill-stale    # Linux: fuser -k on the dev port
resuma dev --skip-runtime
# Watches src/, public/, and Cargo.toml

resuma build

resuma build                    # release binary
resuma build --static-export    # HTML from src/pages/
resuma build --static-export --out dist --base-url https://example.com

resuma routes

resuma routes --path src/pages
    resuma routes --generate --path src/pages