On this page
CLI reference for fastware dev: run, status, and stop commands that manage the file-driven Vite + backend development environment.
#fastware dev
Run and manage the file-driven development environment
#dev run
Start the dev environment by reading [tool.fastware.dev] from the nearest pyproject.toml, running pre-spawn gates to check prerequisites, launching auxiliary services and the Vite frontend dev server, wrapping the ASGI app with ViteDevProxy for backend-first routing, and starting the Granian server in the foreground by default
Effect: mutating
#Flags
| Name | Short | Type | Default | Env | Description |
|---|---|---|---|---|---|
--daemon | bool | Detach and run the dev environment in the background, registering it in the instance registry (query with 'dev status', stop with 'dev stop'). Default runs in the foreground and blocks until Ctrl+C. | |||
--grace | int | 10 | Seconds to wait for a component to stop gracefully before SIGKILL. |
#dev status
List all running fastware dev environments registered in the instance registry, showing the instance name, process ID, and port for each entry. Instances register when started with --daemon and are automatically removed when they exit or are stopped with dev stop
Effect: mutating
#dev stop
Stop all running dev environments by sending SIGTERM for a graceful shutdown. If a process does not exit within the grace period (default 10 seconds, configurable with --grace), it is forcibly terminated with SIGKILL. Stopped instances are removed from the instance registry
Effect: mutating
#Flags
| Name | Short | Type | Default | Env | Description |
|---|---|---|---|---|---|
--grace | int | 10 | Seconds to wait for a dev environment to stop gracefully before SIGKILL. |