@juriba/yalla-cli
v0.1.0
Published
Production-grade, AI-agent-first CLI for Dokploy. Native Go binary fetched on install.
Readme
@juriba/yalla-cli (npm wrapper)
This package wraps the native yalla Go
binary so it can be installed and executed via npm and npx.
How it works
npm install -g @juriba/yalla-cliruns thepostinstallscript.- The script downloads the matching native binary from the public RustFS
release mirror for the wrapper's
package.jsonversion. - The binary's SHA256 is verified against the release
checksums.txtbefore it is unpacked intonode_modules/@juriba/yalla-cli/binaries/. - The
yallabin script inbin/yalla.jsis a thin trampoline. It execs the native binary with the caller's argv, inheriting stdio so stdout, stderr, and exit codes flow through unmodified.
Environment overrides
| Variable | Effect |
|-------------------------|------------------------------------------------------------------------|
| YALLA_VERSION | Force a specific release version (without the leading v). |
| YALLA_REPO | Use GitHub Releases for a specific <owner>/<repo> slug instead. |
| YALLA_RELEASE_BASE | Override the full release base URL. |
| YALLA_SKIP_DOWNLOAD=1 | Skip the postinstall download (useful in restricted CI environments). |
Release mirror
The default public mirror is:
https://s3.jsa.sa/yalla-releases/releases/downloadRelease assets must be uploaded under the tag path:
releases/download/v0.1.0/yalla_0.1.0_linux_amd64.tar.gz
releases/download/v0.1.0/yalla_0.1.0_checksums.txtThe GitHub release workflow uploads GoReleaser archives and checksums to the
yalla-releases RustFS bucket. The bucket or releases/download/ prefix must
allow unauthenticated read access so npm installs work for users without access
to the private source repository.
Test the platform mapping
cd npm
node --test test/*.jsManual one-shot run via npx
npx @juriba/yalla-cli --versionnpx invokes the same wrapper, so the binary is downloaded into a
per-invocation cache and the wrapper exec preserves stdout/stderr/exit codes
exactly.
