CLI / Diagnostics

Diagnostics and cleanup

Check the environment, inspect a project, print versions, and remove only tracked build artifacts.

Start with:

shell
bornengine doctor

The doctor checks Perry, Rust, the package manager, the project, and host prerequisites. Fix the first failing check before chasing later errors. bornengine info prints the CLI, engine, Perry, project, and host details that matter in a support report; bornengine version prints the installed CLI version.

shell
bornengine info
bornengine version

Clean safely

shell
bornengine clean

clean removes only files recorded in the CLI manifest, including generated build output. It does not delete source files, dependencies, or unrelated untracked files. If a dependency install failed, the generated source remains so you can retry with the selected package manager.

Use the repeatable -v / --verbose flag when the first diagnostic is not enough context.

Command reference

Clean generated artifacts

Remove BornEngine-generated build and development artifacts.

bornengine clean

Options

  • -v, --verbose (repeatable)

Behavior

Removes tracked artifacts such as .bornengine/builds/ and development output. It does not delete source files.

Examples

bornengine clean

Show project information

Print the project and selected engine configuration.

bornengine info

Options

  • -v, --verbose (repeatable)

Behavior

Displays information useful for support reports without changing the project.

Examples

bornengine info

Print the CLI version

Show the installed BornEngine CLI version.

bornengine version

Options

  • -v, --verbose (repeatable)

Behavior

Prints the CLI version and exits without touching project files.

Examples

bornengine version