Skip to main content
The CLI provides commands for running both unit tests and workflow tests, letting you validate your backend logic directly from the terminal.
Test commands require a workspace ID, either from your profile or via the -w flag.

Unit Tests

Unit tests validate individual functions and logic blocks.

List Unit Tests

Filter by branch or object type:

Run a Unit Test

Run All Unit Tests

Filter by branch or object type:

Workflow Tests

Workflow tests validate end-to-end backend logic by running test suites.

List Tests

Filter by branch with -b: Use -o json for the full JSON response.

Get Test Details

FlagDescription
--include-draftInclude the draft version of the test
-oOutput format: summary, json, or xs (XanoScript source)

Run a Test

Run All Tests

Run every workflow test in the workspace: Filter by branch with -b:

Delete a Test

Add -f to skip the confirmation prompt.