SuperPowers Streamer CLI

Use this skill when the user only needs the published npm package workflow.

Assume:

• no source-code access
• no repo edits
• the package can be installed in any normal npm environment

Important Behavior

This skill's helper script does not build local source code.

It will:

• install the published third-party npm package superpowers-ai into the skill's local .superpowers/npm directory
• execute the locally installed CLI from that isolated state directory
• do that using the user's current npm config and normal local permissions

It does not perform a global npm install.

Use this skill only when that package-install-and-run behavior is what the user wants.

Package Provenance

The helper is designed around this published package:

• npm package: superpowers-ai
• npm page: https://www.npmjs.com/package/superpowers-ai
• expected npm publisher: superpowersai
• expected maintainer email: rohan@getsupers.com

When explaining this skill, be explicit that it installs and executes that published npm package on the user's machine.

The helper is intentionally pinned to that one package. It does not accept an alternate npm package name.

Main Flow

1. Confirm node and npm exist.
2. Install superpowers-ai into .superpowers/npm.
3. Run the login or create-account flow.
4. Let the package auto-start the streamer after verification.
5. If needed, start it again manually and open the printed /general control link.

Fastest Path

Run:

node scripts/install_and_run.js

That script:

• installs the published third-party npm package superpowers-ai into .superpowers/npm
• retries with a temp npm cache if the normal install fails
• runs the locally installed CLI from the skill state directory
• runs the package's login flow by default

Other Modes

Install only:

node scripts/install_and_run.js --install-only

Start only:

node scripts/install_and_run.js --start

Stop the local streamer:

node scripts/install_and_run.js --stop

Show the saved account:

node scripts/install_and_run.js --whoami

Log out:

node scripts/install_and_run.js --logout

Customer Commands

Through this skill helper, the main commands are:

node scripts/install_and_run.js
node scripts/install_and_run.js --start
node scripts/install_and_run.js --stop
node scripts/install_and_run.js --whoami
node scripts/install_and_run.js --logout

macOS Notes

On macOS, the user may need to allow:

• Screen Recording
• Accessibility

If macOS prompts for permissions, approve them and rerun:

node scripts/install_and_run.js --start

Troubleshooting

Read references/install.md for install and usage wording.

Read references/troubleshooting.md for common npm, login, and streaming failures.