nx — Noxs command line, portable edition

The Noxs terminal nx command, packaged for every OS. Install it once with npm and run the Noxs plugin/package tooling from any shell — Windows (cmd, PowerShell), macOS (zsh/bash), Linux (bash/zsh/fish). Zero runtime dependencies: pure Node.js built-ins.

Install

npm install -g @crossberryweb/nx

or run it without installing:

npx @crossberryweb/nx plugins

Two commands are registered: nx and noxs-nx (identical). Use noxs-nx if you also have the unrelated "Nx" build system installed globally and want to avoid a shim collision.

Commands

| Command | What it does | |---|---| | nx plugins | List every plugin in the Noxs plugin registry (id, version, description) | | nx info <plugin-id> | Show one plugin's metadata: version, release artifact, SHA-256 | | nx install <id> [dir] | Download the plugin artifact and verify its SHA-256 before saving it | | nx pkg info <name\|user/repo> | Inspect a noxs-pkg style package registry (versions, architectures) | | nx ow <url> | Open a URL — the Noxs floating browser on a Noxs device, the default browser elsewhere | | nx version | Print the CLI version | | nx help | Show usage |

Examples

nx plugins
nx info payload-lab
nx install code ./plugins
nx pkg info some-package        # noxs-pkg/<name> registry
nx pkg info owner/repo          # any GitHub-hosted pkg registry
nx ow https://example.com

Security model

Same rules as the on-device nx:

• Registry metadata is treated strictly as data; artifact URLs are only accepted when they point at the official GitHub release asset path.
• Every downloaded artifact is hashed with SHA-256 and compared against the checksum published in the registry manifest. Mismatches are deleted.
• Only https:// URLs are fetched. Plugin ids and file names are validated against strict patterns before use.

Environment overrides

| Variable | Default | Purpose | |---|---|---| | NX_PLUGINS_OWNER / NX_PLUGINS_REPO | crossberry-in / nx-pkg | Source repo of the plugin registry | | NX_OFFICIAL_ORG | noxs-pkg | Org assumed by nx pkg info <name> |

Links

• Plugin registry: https://github.com/crossberry-in/nx-pkg
• npm: https://www.npmjs.com/package/@crossberryweb/nx