axs — Noxs Agent web UI

One command, one URL: npx @crossberryweb/axs starts the Noxs Agent control center — a React web UI served from your machine at http://localhost:4170 — and opens it for you. On a Noxs device terminal it opens in the Noxs floating browser (same bridge as nx ow); on Windows, macOS or Linux it opens the system default browser. Works from any OS shell: cmd, PowerShell, bash, zsh, sh.

Naming note: the bare npm name axs is taken (an unrelated React styling package), so the agent UI ships scoped as @crossberryweb/axs with the command name axs — exactly like @crossberryweb/nx does for nx.

Run it

npx @crossberryweb/axs              # start + open the UI at localhost
npx @crossberryweb/axs --no-open    # start, just print the URL
npm install -g @crossberryweb/axs   # or install once...
axs                                 # ...and run `axs` from any shell

Requires Node.js >= 16. Zero runtime dependencies (Node built-ins only; the React UI is pre-bundled).

What the UI does

• Plugin registry — lists every Noxs plugin from crossberry-in/nx-pkg with its npm-published version (@crossberryweb/noxs-*).
• One-click install — runs npm install -g @crossberryweb/noxs-<id> from the UI with a live log panel; installed versions are detected via npm ls -g.
• Update awareness — cards show installed vX -> vY when a newer npm version exists.
• Environment chips — axs/node/platform versions, server uptime, and whether the Noxs browser bridge is available on this machine.
• Shell cheat-sheet — copy-paste commands for axs, nx ow, and direct npm i -g installs.

Options

| Option | Effect | | ---------------- | ------------------------------------------------------------- | | -p, --port <n> | port (default 4170; busy ports auto-scan up to +49) | | --host <addr> | bind address (default 127.0.0.1; use 0.0.0.0 for LAN) | | --no-open | headless start — do not open any browser | | -v, --version | print version | | -h, --help | help |

HTTP API (localhost only)

| Endpoint | Method | Purpose | | -------------------- | ------ | ------------------------------------------------ | | /api/health | GET | axs/node/platform/uptime info | | /api/packages | GET | registry packages + npm latest versions (60s cache) | | /api/installed | GET | globally installed @crossberryweb/* packages | | /api/install | POST | { "id": "<plugin-id>" } → job id | | /api/jobs/:id | GET | job status + output tail | | /api/bridge | GET | Noxs floating-browser bridge availability |

Install requests are validated against the registry (unknown ids and path traversal are rejected) and the server binds 127.0.0.1 by default.

Related packages

• @crossberryweb/nx — portable Noxs CLI (plugins, info, install, pkg info, ow).
• @crossberryweb/noxs-* — the 14 Noxs plugins on public npm.

License

MIT