Running a room with Survey the Room
For the person at the front. A harness such as Claude reads surveytheroom.com/help.txt instead.
New here? Connect Survey the Room to Claude first. Once it is connected you can skip the commands on this page and just say what you want.
Start a room
Do this once, before people arrive.
export SURVEYTHEROOM_API_KEY=your-key surveytheroom room create naper --title "Naperville AI Enthusiasts"
The reply holds three links. Open screen on the projector. Open admin on your phone; it is your remote, and it is shown only this once. The room's address, surveytheroom.com/naper, and its QR code never change.
Run a round
Say what you want to Claude, as you would to a person: "Ask the room for their prediction for AI in 2033, three answers each." It runs commands like these:
surveytheroom ask --room naper --text "Your prediction for AI in 2033" --entries 3 surveytheroom categories set current --room naper --category "Jobs" --category "Health" surveytheroom next --room naper --title "Which three matter most?" --max 3 surveytheroom results current --room naper surveytheroom close current --room naper
A new question is on every phone the moment its command returns, and it closes the round before it. Nobody scans a second code.
What the numbers mean
- Phones here
- How many phones have opened the room.
- Answered
- How many phones have sent something for this round, out of those that were shown it. "37 of 44" means seven people are still thinking.
- Not sorted
- Answers that fit none of the categories. They are kept and can be placed by hand.
Your remote
The admin page works on your phone and does not need the laptop. It closes or reopens the round, hides an answer, and shows the QR code full screen. Closing acts on the first tap; "Reopen this round" is the undo. It cannot create a question or delete anything.
When something goes wrong
- A phone is not updating. It catches up by itself within a few seconds. If one does not, refreshing that phone is safe: sent answers are kept.
- The wifi is the problem. Cellular works too. Say so to the room.
- An answer you want off the screen. Tap Hide beside it on the admin page. Press and hold Hide to hide everything that phone sent.
- Sorting is paused. Answers are still saved and shown. Claude can place them, or you can vote on options it writes itself.
- You lost the admin link.
surveytheroom admin rotate --room napergives a new one and switches the old one off.
What your audience should know
- Answers are deleted from Survey the Room 30 days after the question was asked. The report is the copy to keep:
surveytheroom report naper --html report.html. - A first name is optional. It appears beside that person's answers on the screen.
- One phone counts once. It can change its answer until the round closes.
- A second browser, or a phone with its browsing data cleared, counts as a second person.
Writing questions that fit the screen
- A question under 70 characters.
- A vote option under 30 characters.
- At most 10 options in a vote.