Skip to content
Back to search

superpowers-streamer-cli

SkillWorks with Claude CodeGitHub

Install, log into, run, and troubleshoot the published SuperPowers desktop streamer npm package. Use when a user wants to set up `superpowers-ai` from npm, sign in or create an account with email or phone, start the streamer, open the printed control link, stop it later, or recover from common npm or runtime issues without needing source-code access.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/rohanarun--phoneclaw/badge.svg)](/listings/rohanarun--phoneclaw)

HTML

<a href="/listings/rohanarun--phoneclaw"><img src="/api/listings/rohanarun--phoneclaw/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 101 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. ---
  2. name: superpowers-streamer-cli
  3. description: Install, log into, run, and troubleshoot the published SuperPowers desktop streamer npm package. Use when a user wants to set up `superpowers-ai` from npm, sign in or create an account with email or phone, start the streamer, open the printed control link, stop it later, or recover from common npm or runtime issues without needing source-code access.
  4. ---
  5. # SuperPowers Streamer CLI
  6. Assume the skill does not have repo or source-code access. Work only from the published npm package and the user's terminal environment.
  7. ## Use This Skill For
  8. - Installing the published `superpowers-ai` npm package
  9. - Helping a user log in or create an account with email or phone verification
  10. - Starting the local streamer and using the printed control link
  11. - Stopping the streamer later
  12. - Troubleshooting npm install problems, login problems, or package runtime issues
  13. ## Core Rules
  14. - Do not assume any local source tree or machine-specific filesystem layout.
  15. - Do not tell the agent to edit repo files unless the user explicitly says they have the source code and wants development help.
  16. - Prefer the published package workflow first.
  17. - Keep commands customer-facing and simple.
  18. ## Standard Flow
  19. 1. Check that Node and npm exist.
  20. ```bash
  21. node -v
  22. npm -v
  23. ```
  24. 2. Install the package.
  25. ```bash
  26. npm install -g superpowers-ai
  27. ```
  28. If the user's npm cache is broken or permission-denied, retry with a clean temp cache:
  29. ```bash
  30. mkdir -p /tmp/superpowers-npm-cache
  31. npm_config_cache=/tmp/superpowers-npm-cache npm install -g superpowers-ai
  32. ```
  33. 3. Log in or create the account.
  34. ```bash
  35. superpowers login
  36. ```
  37. This should prompt for:
  38. - email or phone
  39. - verification code
  40. 4. Tell the user that the package should start the streamer and print a control link automatically after login.
  41. 5. If needed, start again manually.
  42. ```bash
  43. superpowers start
  44. ```
  45. 6. To stop the local streamer later:
  46. ```bash
  47. superpowers stop
  48. ```
  49. 7. Helpful account commands:
  50. ```bash
  51. superpowers whoami
  52. superpowers logout
  53. ```
  54. ## Customer Guidance
  55. - Install package: `npm install -g superpowers-ai`
  56. - Start login: `superpowers login`
  57. - Start again manually: `superpowers start`
  58. - Stop streamer: `superpowers stop`
  59. - Open the printed `/general` control link in the browser to control the stream
  60. ## macOS Notes
  61. On macOS, the user may need to allow:
  62. - Screen Recording
  63. - Accessibility
  64. If macOS prompts for permissions, tell the user to approve them and then rerun:
  65. ```bash
  66. superpowers start
  67. ```
  68. ## Troubleshooting
  69. Read `references/install.md` for install and usage wording.
  70. Read `references/troubleshooting.md` for common npm, login, and streaming failures.
README.md · README · 135 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. **PhoneClaw**
  2. PhoneClaw is an Android automation app that runs on-device workflows and lets you generate automation logic at runtime using **ClawScript**, a JavaScript-based scripting language built into the app.
  3. PhoneClaw is inspired by Claude Bot/Claude Code and attempts to rebuild the agent loop for android phones natively to act as your personal assistant with access to all your apps.
  4. **OpenClaw Install***
  5. npm install -g superpowers-ai
  6. superpowers --help
  7. Open the URL it gives you to control the stream.
  8. npm package: https://npmjs.com/package/superpowers-ai
  9. Chrome Extension: https://chromewebstore.google.com/detail/superpowers-ai/oolmdenpaebkcokkccakmlmhcpnogalc
  10. Clawhub: https://clawhub.ai/rohanarun/super-powers
  11. **Docs**
  12. https://rohanarun-phoneclaw.mintlify.app/
  13. **Demos**
  14. World's first software-only iPhone Automation: https://www.youtube.com/watch?v=QT67RvAt69o
  15. Live demo: https://getsupers.com
  16. iOS App: https://apps.apple.com/us/app/superpowers-ai/id6758969961
  17. Apple Vision Pro demo: https://x.com/Viewforge/status/2028401641549164834
  18. Automate your old Androids: https://youtube.com/live/Thc2sAt8uuk
  19. Automated locking agent: https://x.com/Viewforge/status/2028591471860097289
  20. Automated X Community Mod Agent: https://x.com/Viewforge/status/2028115961711415657
  21. $phoneclaw(Solana token) integrated into our app: https://x.com/Viewforge/status/2026482468430426558
  22. Flying Drones with AI:
  23. [![Flying Drones with AI:](https://img.youtube.com/vi/SWb7RLR1lD0/0.jpg)](https://www.youtube.com/watch?v=SWb7RLR1lD0)
  24. Automating Twitter In A Waymo With Android XR
  25. [![Automating Twitter In A Waymo:](https://img.youtube.com/vi/_F5Wfbragh8/0.jpg)](https://www.youtube.com/watch?v=_F5Wfbragh8)
  26. Automating Uploading Videos To Tiktok With Songs:
  27. [![Automating Uploading Videos To Tiktok With Songs:](https://img.youtube.com/vi/TRqPFSixaog/0.jpg)](https://www.youtube.com/watch?v=TRqPFSixaog)
  28. Automating Creating Instagram Accounts With 2FA From Email:
  29. [![Automating Creating Instagram Accounts](https://img.youtube.com/vi/9zR43vLYCMs/0.jpg)](https://www.youtube.com/watch?v=9zR43vLYCMs)
  30. Automating Captchas:
  31. [![Automating Captchas:](https://img.youtube.com/vi/aBgbr27fR5M/0.jpg)](https://www.youtube.com/watch?v=aBgbr27fR5M)
  32. **Updates**
  33. - 2/19/26 updated to allow selecting the openrouter model
  34. **What It Can Do**
  35. - Automate multi-step app workflows on Android using the Accessibility service.
  36. - Generate scripts at runtime for flexible, adaptive automations.
  37. - Use vision-assisted UI targeting to click controls without hardcoded coordinates.
  38. - Read visible on-screen text and values for branching, validation, and handoffs.
  39. - Schedule automations with cron-like timing for recurring tasks.
  40. - Chain actions across apps (browser, email, media, messaging) inside a single flow.
  41. - Build flows that adapt to different device sizes, layouts, and language settings.
  42. **Setup Instructions**
  43. 1) The cheapest phone is a $30 Moto G play you can buy at Walmart in the US. It is the phone used in the demos.
  44. 2) Enable developer mode on your android. You do not need to root the device.
  45. 3) Download Android Studio, download this Repo, open the Repo, and click Build > Generate Bundles or APKs > Generate APKs.
  46. 4) Sideload the APK by downloading it or transferring it to your android and clicking install. Click allow when it asks for permissions.
  47. 5) When the app opens, use the voice commands to generate a simple automation like "open twitter and click the blue post button every hour"
  48. 6) It will run the agent, schedule it, then output a file you can edit in simple language like below.
  49. **ClawScript**
  50. ClawScript runs inside PhoneClaw using an embedded JS engine and exposes helper functions for automation, scheduling, and screen understanding. It is designed for fast iteration: write or generate small scripts at runtime, execute them immediately, and adjust based on UI feedback.
  51. **ClawScript API (Core Helpers)**
  52. - `speakText(text)` — Reads out text using on-device TTS to confirm state or provide progress.
  53. - `delay(ms)` — Pauses execution for a specific number of milliseconds.
  54. - `schedule(task, cronExpression)` — Registers a task string to run on a cron-like schedule.
  55. - `clearSchedule()` — Removes all scheduled tasks.
  56. - `magicClicker(description)` — Finds a UI element by natural-language description and taps it.
  57. - `magicScraper(description)` — Answers a targeted question about what is visible on screen.
  58. - `sendAgentEmail(to, subject, message)` — Sends an email from the device for notifications or handoffs.
  59. - `safeInt(value, defaultVal)` — Safely parses values to integers with a fallback.
  60. **magicClicker**
  61. - Uses a screenshot plus vision to locate a target described in plain language.
  62. - Taps the best-matching UI element through the Accessibility service.
  63. - Best for repeatable flows where the UI layout may shift between devices.
  64. **magicScraper**
  65. - Uses a screenshot plus vision to answer a targeted question about what is visible.
  66. - Returns a concise string that you can parse or branch on in your script.
  67. - Best for reading text like OTP codes, status labels, or field values.
  68. **Example Script**
  69. ```js
  70. magicClicker("Create account")
  71. delay(1500)
  72. magicClicker("Email address field")
  73. // ... type text via your own input helpers
  74. magicClicker("Next")
  75. const otp = magicScraper("The 2FA code shown in the SMS notification")
  76. // ... submit otp
  77. ```
  78. **Setup**
  79. - Provide your Moondream auth token via Gradle properties (kept out of git):
  80. ```properties
  81. # local.properties (project root) OR ~/.gradle/gradle.properties
  82. MOONDREAM_AUTH=YOUR_TOKEN_HERE
  83. ```
  84. **Community**
  85. Discord: https://discord.gg/supers
  86. Youtube: https://www.youtube.com/@getsuperpowers
  87. Twitter: [https://x.com/i/communities/2025816983716184465](https://x.com/i/communities/2026071470741635468)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.