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 #315
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:
~/.local/bin/cora # v0.6.0 (binary release, but killed by Gatekeeper — see #313)
~/.cargo/bin/cora # v0.6.0 (cargo build)
~/.bun/bin/cora # v0.2.4 (stale npm — see #314)
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.
Surfaced while trying to run cora scan on a downstream project (codecoradev/rungu) and getting confusing results because v0.2.4 was silently being invoked. Cleaner install docs would have prevented a half-hour of debugging.
Activity
ajianaz commentedon Jun 17, 2026
Closing as duplicate of #314 (same title, same body, same author, opened 3 seconds apart). Tracking in #314.
docs(install): warn about multiple distribution channels (#314)
docs(install): warn about multiple distribution channels (#314) (#320)