stagecoach-ai
v0.1.16
Published
Thin npm wrapper that downloads and runs the stagecoach native binary — a snapshot-based AI commit-message generator that uses YOUR local CLI agent.
Downloads
1,047
Maintainers
Readme
stagecoach-ai
stagecoach-ai is a thin npm wrapper that downloads the stagecoach native binary at install time (via a postinstall script) and execs it on every stagecoach invocation. stagecoach is a snapshot-based AI commit-message generator that uses YOUR local CLI agent. If the postinstall download was blocked (for example by running npm install --ignore-scripts or a corporate npm mirror that disables scripts), the stagecoach command prints a message pointing at https://github.com/dabstractor/stagecoach#install — install directly or use a package manager that allows postinstall.
Install
npm install -g stagecoach-ai
stagecoachSee the main repository for features, configuration, and the full CLI reference.
Publishing (for maintainers)
This package is published automatically when a v* tag is pushed (the same tag that fires
goreleaser).
goreleaser has no native npm pipe, so an npm-publish job (in release.yml) runs after the
goreleaser job:
- Syncs
package.jsonversionto the tag (v1.2.0→1.2.0; the committedversionstays0.0.0, a dev placeholder). npm install --ignore-scripts --no-package-lock— validates thetar/extract-zipdeps resolve WITHOUT runningpostinstall(the native binary is fetched at user install time, not publish time) and WITHOUT writing a lockfile into the tarball.npm publish— the package is unscoped (stagecoach-ai), so it is public by default; no--accessflag is needed (that flag is scoped-packages-only).
Required secret: NPM_TOKEN — an npm automation token (npmjs.com → Access Tokens →
"Automation"), which bypasses publish 2FA for non-interactive CI. Add it under the repo's
Settings → Secrets → Actions. (A "Publish" token will fail in CI if the account has publish 2FA on.)
The wrapper's smoke tests (the shim + the installer) run on every PR in
ci.yml (npm-smoke
job) to catch regressions before a release. See the main repo's
distribution notes for all install channels.
Optional future enhancement: add a
filesfield topackage.jsonto slim the tarball (thetest/*files currently ship, ~9KB extra, which is harmless) and/or usenpm publish --tag nextfor prerelease tags sonpm installdoes not resolve an RC aslatest. Both require apackage.jsonchange and are intentionally out of scope for the initial publish wiring.
