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

What your audience should know

Writing questions that fit the screen