nanvix/test
.github/skills/test/SKILL.md
Guide for running Nanvix tests with z. Use this when asked to run unit tests, integration tests, or the full test suite.
$ install --global
skillsauthnpx skillsauth add nanvix/nanvix testInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 7, 2026, 8:27 PM26.7s1 file scanned
SKILL.md
- name:
- test
- description:
- Guide for running Nanvix tests with z. Use this when asked to run unit tests, integration tests, or the full test suite.
Test Nanvix
Use this skill when the user asks to run tests on Nanvix. This covers unit tests, system
integration tests, and the combined test suite exposed through the z utility.
Prerequisites
- Development environment set up per
doc/setup.md. - A successful build of the components under test (see the
buildskill).
Unit Tests
./z build -- run-unit-tests
System Integration Tests (microvm and hyperlight only)
./z build -- run-nanvix-tests
Test configurations are auto-selected based on deployment mode:
- Single-process:
test/test-single_process.toml - L2 VM:
test/test-l2.toml - Multi-process:
test/test-multi_process.toml
All Tests
./z build -- test
Windows
On Windows, unit tests can be run natively through z.ps1:
.\z.ps1 build -- run-unit-tests
System integration tests (run-nanvix-tests) and nanvixd-based tests are Linux-only.
The standalone UserVM can be launched on Windows for manual verification, but the automated
test harness (nanvix-test) requires nanvixd, which is not available on Windows.
Troubleshooting Test Failures
- Ensure the project builds successfully before running tests (see the
buildskill). - Use
LOG_LEVEL=traceorLOG_LEVEL=debugfor more verbose output when diagnosing failures. - Hyperlight does not support ramfs, so standalone integration tests must be excluded for hyperlight.
- See the
troubleshootingskill for deeper diagnosis of runtime and test failures.
Related Skills
nanvix/ci-cd-pipeline
testing
VerifiedTrustedCommunity
Guide for Nanvix CI and GitHub Actions workflow behavior, including local pipeline execution and matrix coverage. Use this when asked about CI checks, workflow failures, or release flow.
224SKILL.mdUpdated Apr 7, 2026
nanvix/user-app-development
development
VerifiedTrustedCommunity
Guide for developing, building, and running Nanvix user-space applications across supported runtimes and languages. Use this when asked about guest app implementation or execution.
221SKILL.mdUpdated Apr 7, 2026
nanvix/troubleshooting
development
VerifiedTrustedCommunity
Guide for diagnosing Nanvix build, runtime, and test failures, including cleanup and debugging workflows. Use this when asked to investigate errors or unstable behavior.
221SKILL.mdUpdated Apr 7, 2026
nanvix/test-development
development
VerifiedTrustedCommunity
Guide for writing, running, and debugging Nanvix unit, integration, and system tests in Rust and C/C++. Use this when asked about test implementation or failures.
221SKILL.mdUpdated Apr 7, 2026