@kubbisec/naus

Official KubbiSec Naus CLI — register runners, execute pipelines, and validate definitions against the KubbiSec control plane.

Naus connects your infrastructure to KubbiSec CI/CD: secure runner enrollment, remote job execution, and local pipeline workflows.

Features

• Runner lifecycle — register with a bootstrap token, start the agent, and report to your organization’s control plane.
• Pipelines — run YAML pipelines locally or integrate with hosted runs.
• Validation — catch pipeline errors before they hit the cluster.
• Native binaries — platform-specific executables via optionalDependencies (no postinstall scripts; compatible with npm install --ignore-scripts).

Requirements

• Node.js 18 or newer (for the global install and launcher).
• Docker (or equivalent) when jobs use containerized steps — see your organization’s documentation.

Installation

npm install -g @kubbisec/naus

Quick start

# Enroll a runner (replace URL with your KubbiSec API / enrollment endpoint)
naus register <bootstrap-token> --api https://your-api.example.com

# Start the runner process
naus start

# Run a pipeline file locally
naus run pipeline.yml

# Validate a pipeline without executing
naus validate pipeline.yml

Run naus --help for the full command tree and flags.

Supported platforms

The meta-package @kubbisec/naus pulls the correct native binary for your OS and CPU:

| OS | Architecture | npm package | |---------|--------------|--------------------------------| | Linux | x64 | @kubbisec/naus-linux-x64 | | Linux | arm64 | @kubbisec/naus-linux-arm64 | | macOS | arm64 | @kubbisec/naus-darwin-arm64 | | Windows | x64 | @kubbisec/naus-win32-x64 |

You normally do not install the platform packages directly; install @kubbisec/naus globally.

License

MIT — see LICENSE in this package.

Trademarks

KubbiSec and related marks are property of their respective owners. This package is distributed by KubbiSec for use with the KubbiSec platform.