FilOzone / FilOzone/filecoin-nova
npx filecoin-nova fails: "could not determine executable to run"
- Dominant language
- TypeScript
- Stars
- 1
- Forks
- 4
- PR merge metrics
- No merged PRs in 30d
Description
## Summary
Running the documented command `npx filecoin-nova ` fails with `could not determine executable to run`. The package ships two bins (`nova`, `nova-mcp`) and neither matches the package name, so `npx` can't resolve which executable to run.
## Reproduction
```bash
npx filecoin-nova demo https://www.namespace.ninja
```
## Actual result
```
npm error could not determine executable to run
npm verbose pkgid filecoin-nova@0.7.10
npm error A complete log of this run can be found in: ...
```
## Root cause
`npx ` auto-runs a bin only when the package has **one** bin, or a bin whose name **matches the package name**. The current `package.json`:
```json
"bin": {
"nova": "./dist/cli.js",
"nova-mcp": "./dist/mcp.js"
}
```
has two bins, neither named `filecoin-nova`, so `npx filecoin-nova ...` cannot resolve an executable.
This is made worse by the README, which documents the broken form:
- `README.md:6` — `npx filecoin-nova demo https://your-site.com`
- `README.md:29` — same
- `README.md:37` — `npx filecoin-nova demo ./dist`
So the documented command and the published bins are inconsistent.
## Workaround
```bash
npx -p filecoin-nova nova demo https://www.namespace.ninja
# or
npm i -g filecoin-nova && nova demo https://www.namespace.ninja
```
## Proposed fix
Add a `filecoin-nova` bin alias pointing at the same CLI entry, so the documented (and most natural) command works while keeping the short `nova` form:
```json
"bin": {
"nova": "./dist/cli.js",
"filecoin-nova": "./dist/cli.js",
"nova-mcp": "./dist/mcp.js"
}
```
The existing `build` script already `chmod +x dist/cli.js`, so no build change is needed — just a version bump and republish.
## Environment
- `filecoin-nova@0.7.10` (also affects `0.7.11`)
- node v24.10.0, npm v11.6.1
- macOS (Darwin 25.5.0)
Contributor guide
No contributing guide indexed for this repository
Assessment
This issue has not been assessed yet.