Reporsa CLI
This package launches the native Reporsa CLI and installs the matching complete runtime through an optional alias to a platform version of this same package. No Rust, pnpm, or source checkout is needed. Node.js >= 22.14 is required for the npm launcher. Do not omit optional dependencies. This release provides Windows x64, Linux x64 (glibc >= 2.35), and macOS Intel and Apple Silicon. Linux requires Ubuntu 22.04 or an equivalent glibc environment; Alpine/musl and Linux arm64 are not supported.
Published npm versions are public and require no npm account to install:
npm install --global @algforce_ai/reporsa
reporsa --version
reporsa doctor --json
reporsa describe --json
reporsa guide start
For a pinned temporary invocation, use npx --yes @algforce_ai/reporsa@<version> describe --json. For an update, install the desired exact version globally again.
Uninstall with npm uninstall --global @algforce_ai/reporsa. Stop any running report browser
with reporsa web stop --json before changing or removing installations.
Check this installation with reporsa update --check --json, or upgrade it with
reporsa update --json. The updater preserves its actual global prefix, including
private agent-host installations. Ordinary commands show cached update notices on
stderr, with background checks at most daily. Set REPORSA_AUTO_UPDATE=1 to upgrade
before a command, REPORSA_PIN_VERSION=<exact-version> to keep a fixed version, or
REPORSA_NO_UPDATE_NOTIFIER=1 to disable automatic checks. Read reporsa guide updates
for agent startup, service restart requirements and unsupported installation modes.
Report workspaces and report browser configuration live outside the package.
The runtime includes Node, report browser, guides and schemas. PNG capture reuses a working Chrome, Edge or Chromium; when none is usable, the first PNG request downloads the matching checksum-pinned headless browser into a user cache. Safari can remain the default macOS viewer. Core validation and Office exports do not need a running report browser or browser. Installation does not configure an agent or create a workspace.
Original Reporsa code is licensed under AGPL-3.0-only. ALGFORCE INC. may offer separate commercial terms; contact [email protected]. See LICENSE and LICENSING.md. Third-party code and the embedded font retain their own terms. The intended source repository is https://github.com/algforcexu/reporsa-cli.
The source template remains private:true to prevent accidental publishing from
a checkout. Authorized release archives use public npm access. PNG browser setup
uses the checksum-pinned official Google download on every platform. Linux also
needs unzip for first PNG setup (sudo apt-get install unzip on Ubuntu), and
the system libraries required by Chrome. Core commands and Office exports do not
require unzip or Chrome.
Matching corresponding source: npm pack @algforce_ai/reporsa@<version>-source. See SOURCE.md. The separate Studio application is not included.