CLI Reference

The forge CLI is installed with every project and available globally if you ran npm install -g @fozmu/forge. Run forge help any time for this list.

forge create

Scaffold a new project.

forge create <name> [options]

Flag	Description	Default
`--template, -t`	`app`, `site`, or `api`	`app`
`--pm`	Package manager: `npm`, `pnpm`, `bun`	auto
`--no-install`	Skip dependency installation	`false`
`--no-git`	Skip git initialization	`false`

forge dev

Start the local development server with hot reload.

forge dev [--port <n>]

forge init

Add Forge to an existing project. Non-destructive unless --force is passed.

forge init [--force]

forge db

Database management.

forge db migrate      # apply pending migrations
forge db generate     # generate a migration from schema changes
forge db studio       # open the visual data browser
forge db reset        # drop, recreate, and re-migrate (dev only)

forge db reset is destructive

reset drops your entire database. It refuses to run when NODE_ENV is production.

forge deploy

Build, check, and publish to your configured target.

forge deploy [--target <t>] [--tag <tag>]

Flag	Description
`--target`	Override `deploy.target` from config
`--tag`	Image tag (Docker target only)
`--skip-checks`	Skip the local type/lint/build gate

forge doctor

Diagnose your environment and print a health report.

forge doctor

Exit codes

Code	Meaning
`0`	Success
`1`	Generic failure
`2`	Validation / config error
`3`	Pre-deploy check failed