You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
docs: install instructions don't warn about multiple distribution channels causing PATH conflicts #314
The README/install docs describe how to install cora but don't warn users that three distribution channels exist simultaneously and can conflict on the same machine:
GitHub release binary (~/.local/bin/cora or similar)
cargo install cora-cli (~/.cargo/bin/cora)
npm @codecora/cli (~/.bun/bin/cora or ~/.npm-global/bin/cora — currently v0.2.4, far behind)
Observed problem
On a real developer machine, all three were present simultaneously:
$ ls ~/.local/bin/cora ~/.cargo/bin/cora ~/.bun/bin/cora
/Users/mis-puragroup/.local/bin/cora # v0.6.0 (binary release, but killed by Gatekeeper)
/Users/mis-puragroup/.cargo/bin/cora # v0.6.0 (cargo build)
/Users/mis-puragroup/.bun/bin/cora # v0.2.4 (stale npm)
which cora resolved to whichever appeared first in $PATH, which in this case was the stale npm v0.2.4, silently — no warning, no error. The user thinks they're on the current version.
Suggested doc improvement
Add a short "Installation" section that:
Lists all supported install methods and recommends one primary method per platform.
Includes a "Check your install" snippet:
which cora && cora --version
# If you see anything other than the latest version (currently 0.6.0),# remove the older binary or adjust your PATH.
Warns that the npm package is currently stale (cross-link to the npm-staleness issue).
Documents the macOS Gatekeeper workaround for the binary release (cross-link to the macOS-quarantine issue).
Context
Surfaced while trying to run cora scan on a downstream project and getting confusing results because v0.2.4 was silently being invoked. Cleaner install docs would have prevented a half-hour of debugging.
Update: removed the stale @codecora/cli@0.2.4 from this machine via bun remove -g @codecora/cli — it was shadowing the cargo-installed v0.6.0 in PATH. Only one cora on the system now (~/.cargo/bin/cora v0.6.0). The upstream staleness of the npm package is still a real issue for anyone who installs via npm/bun, so leaving this open.
Activity
ajianaz commentedon Jun 17, 2026
Update: removed the stale
@codecora/cli@0.2.4from this machine viabun remove -g @codecora/cli— it was shadowing the cargo-installed v0.6.0 in PATH. Only onecoraon the system now (~/.cargo/bin/corav0.6.0). The upstream staleness of the npm package is still a real issue for anyone who installs via npm/bun, so leaving this open.docs(install): warn about multiple distribution channels (#314)
docs(install): warn about multiple distribution channels (#314) (#320)
docs: sync website docs for v0.6.1 release (#321)