FilOzone / FilOzone/filecoin-nova

npx filecoin-nova fails: "could not determine executable to run"

Open
#2 0 comments 0 reactions 0 assignees View on GitHub
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.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.