@nwire/please

Operator CLI — dispatch any registered action or query from the command line.

What it does

Looks at every app's registered actions and queries and exposes them as CLI commands. please submissions.flag-for-review --submissionId xyz walks the apps registry, finds the owning app, seeds an envelope, dispatches, prints the result. Same handlers as HTTP/queue — operator parity guaranteed.

Install

pnpm add @nwire/please

Quick start

#!/usr/bin/env node
import { runPlease } from "@nwire/please";
import { apps } from "../app/apps";

runPlease({ apps, argv: process.argv.slice(2) }).then((code) => process.exit(code));

please submissions.flag-for-review --submissionId xyz --confidence 0.4
please lessons.start-attempt --lessonId hebrew-1 --studentId avi
please submissions.by-student --studentId avi --status under-review
please --help

API surface

• runPlease({ apps, appInstances?, argv, stdout?, stderr? }) — returns exit code.

When to use

Operations work — re-run a stuck workflow, query a projection, kick a one-off action — without writing a script or shelling into a worker.