Share to wisp from your phone

On Android

1. In any app, press Share and pick wisp.
2. wisp opens New task with the link or text in the box and the pictures or PDFs attached. What you’d already typed stays, with this below it.
3. Pick the project and harness as usual, and press Send. Nothing starts until you do.

A share takes 10 files and 20 MB at most; a toast says what was left out. If no computer is open, the computers list says it’s waiting, and it lands in New task when you open one.

Installed wisp from your cloud wisp in Chrome instead of the app? It’s in the share sheet too, once you’ve opened it from the Home Screen one time. A share from a browser tab can’t work: Chrome only offers an installed app, and wisp says so if one gets through.

On an iPhone: build a Shortcut

You need wisp Cloud: the Shortcut talks to your cloud wisp at its public address. A computer of yours has no public address of its own for this, and API keys only open your cloud wisp, not a computer you added to it.

First make a key: in your cloud wisp, Settings → Connect → API keys (Settings → Cloud in wisp on a computer signed in to the grid). It starts with wgk_ and is shown once.

1. Open the Shortcuts app and press +. Name it Send to wisp.
2. Press the ⓘ button and turn on Show in Share Sheet. Under what it receives, keep URLs and Text.
3. Add the action Get Contents of URL. For the URL, type https://you.grid.trywisp.dev/api/sessions, with your own handle and grid.
4. Press Show More. Set Method to POST.
5. Under Headers, add one: key Authorization, text Bearer wgk_…, your whole key after the word Bearer and a space.
6. Set Request Body to JSON. Add a Text field with key prompt, and for its value pick the variable Shortcut Input. Add a Boolean field with key scratch, set to True.
7. Optional: add Show Notification with Sent to wisp, so you see it went.

Now Share → Send to wisp in Safari sends what you’re looking at. The request is this:

POST https://you.grid.trywisp.dev/api/sessions
Authorization: Bearer wgk_…
Content-Type: application/json

{ "prompt": "https://example.com/the-page", "scratch": true }

scratch runs the task in an empty folder. To run it in a project, send cwd with that folder’s path on your cloud computer instead. The other fields are in the API reference, under POST /api/sessions.

Your key is a secret

• It lives in your Shortcut, and nowhere else. Don’t paste it into a chat, an issue, a task or a website. Nobody at wisp will ever ask you for it.
• Whoever has it can start tasks on your cloud wisp. Sharing the Shortcut with someone shares the key inside it, so take it out first.
• It can be taken back. Revoke it where you made it and make a new one. The name you gave it says which Shortcut used it.