@godriver/cli
v0.1.0
Published
Command line interface and fail-fast watchdog runner for Godriver
Readme
@godriver/cli
Command line interface and fail-fast watchdog runner for Godriver.
Install
npm install @godriver/cliUsage
# Launch the game (headless by default), wait for /health, run your test suite
godriver --godot /path/to/godot --project . -- cucumber-js features/
# Windowed run (watch the game while tests drive it)
godriver --no-headless --project . -- npm testFlags: --godot <path> (or GODOT_BIN env), --project <dir>, --port <n>
(or GODRIVER_PORT), --no-headless. Everything after -- is passed to the
test runner.
Watchdog
The built-in watchdog polls /health while the game runs. If the health tick
deadline (default 15s) expires, it dumps the game's stderr, kills the process,
and the CLI exits with code 2 — fail-fast for CI instead of a hung job.
Exit codes: 0 success, 1 test failure, 2 infra error (game crash/watchdog).
See the repo docs for details.
