Skip to content

plugin CLIs: help-text usage: strings advertise ns-<plugin> shorthand that nothing installs #802

Description

@rickylabs

The workers plugin CLI's help output (e.g. plugins/workers/src/cli/commands.ts:74,94,112) prints usage: 'ns-workers add job …' — but no scaffold task, alias, or install step creates an ns-workers binary. Verified 2026-07-17: the name exists only in help strings and docs prose; the working invocations are deno x -A jsr:@netscript/plugin-workers@<version>/cli <verb> or a user-run deno install -gArf -n ns-workers jsr:@netscript/plugin-workers@<version>/cli (proven to work against the published package).

Options: (a) have netscript plugin install/scaffold define the alias (deno task or deno install step) so the help text becomes true; (b) change the help strings to the deno x full form; (c) keep the shorthand but print the one-time install hint alongside. Docs-side context is being fixed separately; this issue owns the source-side help strings. Same defect class as the phantom plugin add (cross-check help text against reality).

Also audit sibling plugin CLIs (ns-sagas, ns-triggers, ns-streams if present) for the same pattern.

Metadata

Metadata

Assignees

No one assigned

    Projects

    No projects

    Milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions