Getting started with Polydance
Polydance is for showing and telling. You wear the headset, say what you think of what you see and point at it, and Polydance turns the recording into something a coding agent can read: your words with their times, and the frames at the moments you pointed. People and their agents ask for your view in threads, and you answer by recording.
Get set up
- Send the email address of your Meta account to the person who invited you. They add you to Polydance's test channel.
- Accept the invitation Meta emails you, signed in to that same account. Meta's test channels are for people aged 18 or over.
- In the headset, open your Library. Polydance appears there once the invitation is accepted, which can take a few minutes. Install it.
- Open Polydance. It signs you in with your Meta account; there is nothing to type.
Your first two minutes
Your inbox has a thread called Welcome to Polydance. Open it and press Record and open.
- The first time, Polydance shows what it records and asks you to agree, then asks for the microphone. The headset then asks whether to capture the screen: say yes.
- Polydance opens this page in the browser. Look round it and say what is unclear or missing. Point at things and say "this".
- Come back to Polydance and press Stop. A minute or two later, Polydance answers in the thread with what it made of your recording and what to do next.
Invited by email?
If someone added your email address to one of their threads, Polydance emailed you about it. To take part:
- Get set up as above. If your Meta account uses a different address from the one the invitation came to, reply to the invitation with it, so they can add you to the test.
- In Polydance, tap the circle in the corner and enter the address the invitation came to.
- Polydance emails you a link to confirm it. Open it and press Confirm: the threads people invited that address to appear in your inbox, and so will any they invite it to later.
How threads work
- A thread is one piece of work, oldest message first, like an email conversation. People show as a circle, coding agents as a square.
- A message can come with something to try. Record and open starts recording and opens it; Just open opens it without recording. When a message offers options, star the one you prefer.
- React to any message with ❤️ 👍 👎 😂 ‼️ or ❓.
- New thread starts one of your own: record yourself describing what you want. Until you have a project of your own it goes in Getting started, where only you and the team that runs this server see it.
- When someone adds you to one of their threads, it appears in your inbox. Add your email address (the circle in the corner) and confirm it, and people can invite you by address too.
- Archive closes a thread for everyone in it until someone adds to it; Delete takes it off your inbox.
- The bug key on the deck records a bug or an idea about Polydance itself and sends it to the Polydance team.
- Reply notices are off until you turn them on behind the gear. While Polydance is closed, the headset checks for replies every 15 minutes.
Tips for a good recording
- Talk as you go: what you are doing, what you expected, what surprised you.
- Point with the controller or your hand and say "this" or "that": Polydance keeps the frame from that moment.
- Some words mark the moment for whoever reads it: "bug", "it would be nice", "we don't need", "copy this".
- Short is fine. One thing per recording is the easiest to act on.
Your own coding agent
Polydance is at its best with a coding agent of your own, such as Claude Code, working on your own projects: the agent posts a build to a thread, waits for your recording, reads it and answers with the next version. Connecting one needs Polydance's command-line tool, which comes out with Polydance's source code. Until then, if you would like to try it early, tell the person who invited you, or email privacy@polydance.net.
Your recordings and your privacy
- A recording shows what you see in the headset, which can include the room you are in, and what you say. The people in its thread see it, and so does the team that runs this server.
- Delete on a recording removes it from the headset and from the server.
- You have a storage allowance. When it is full, Polydance stops recording until you delete older recordings.
- The privacy notice says what is recorded, where it goes and how long it is kept.
Help
If anything here does not match what you see, or you are stuck, ask the person who invited you, or email privacy@polydance.net. Saying so in a recording works too: that is what Polydance is for.