test-nf-plugin-commands

A minimal Nextflow plugin that implements PluginExecAware to expose a custom command via nextflow plugin <id>:<cmd>.

This repository is a reproduction case for a bug reported to nextflow-io/nextflow: it is impossible to run nextflow plugin <id>:<cmd> against a locally-installed development version of a plugin (one that has never been published to the Nextflow Plugin Registry).

Reproduction

git clone https://github.com/rcannood/test-nf-plugin-commands
cd test-nf-plugin-commands
make assemble install

Then try any of the following invocations:

# Attempt 1: no version, no offline flag
nextflow plugin test-nf-plugin-commands:hello
# ERROR ~ Cannot find latest version of test-nf-plugin-commands plugin

# Attempt 2: NXF_OFFLINE=true, no version
NXF_OFFLINE=true nextflow plugin test-nf-plugin-commands:hello
# ERROR ~ Cannot find version for test-nf-plugin-commands plugin -- plugin versions MUST be specified in offline mode

# Attempt 3: NXF_OFFLINE=true, version specified (plugin IS installed at ~/.nextflow/plugins/test-nf-plugin-commands-0.1.0/)
NXF_OFFLINE=true nextflow plugin test-nf-plugin-commands@0.1.0:hello
# Cannot find target plugin: test-nf-plugin-commands@0.1.0

All three fail, even though ~/.nextflow/plugins/test-nf-plugin-commands-0.1.0/ exists after make install.

Tested on Nextflow 25.10.4 and 26.04.0.

Commits

• ed4913b — initial plugin scaffold from nf-plugin-template
• 2a5dc0e — implement PluginExecAware (diff)