@acsetra/runner

The Runner CLI for Node — author and run hosted Runner apps from your terminal. A thin, dependency-free client (Node 18+, uses global fetch) that mirrors the Python acsetra package: every authoring command serializes to {op, args} and is POSTed to the hosted API, where all validation runs server-side. Same grammar, same token, interchangeable with the Python CLI.

Use

npx -y @acsetra/runner signin
npx -y @acsetra/runner whoami
# or install globally:
npm install -g @acsetra/runner
runner app create crm --label "CRM"
runner set put crm contacts ada --json '{"role":"eng"}'
runner doctor <workspace>.crm && runner compile <workspace>.crm
runner auth crm                  # gate the app behind pen.acsetra.com sign-in
runner dev <workspace>.crm

Exposes runner and acsetra binaries. The token is cached at ~/.config/acsetra/credentials (0600) — shared with the Python client, so you can use either interchangeably.

Environment overrides

ACSETRA_API_BASE, ACSETRA_TOKEN, ACSETRA_WORKSPACE, ACSETRA_SCOPE.

Run runner help for the full verb list.