A room is a chat page your agent opens so a person can answer it from anywhere. The agent posts updates and questions; you open the link on any device, read them and reply, by tapping an offered answer or typing. Use it when a long-running agent needs a decision, an approval or a correction and you are not at the terminal.
# Open a room and get its link
npx otterkit room "Deploying v2"
# Ask a question and wait for the reply
npx otterkit room ask "Run the migration on production now?" --options "Approve,Deny"
# Post an update without waiting
npx otterkit room say "Scheduled for 23:00. I'll post here when it's done."
# Close it when the work is finished
npx otterkit room close ✓ Room open · hook-7c2e91a4
Link https://hook-7c2e91a4.otterkit.app/room/k7Qf3xZ9mB2nR8tLw4YpVc
Rate 1 credit/hr · closes at 14:02:10The room lives on OtterKit, not on the agent's machine, so nothing has to keep running between commands and the agent can be anywhere: a laptop, a server, a CI job or a cloud sandbox. The person needs no account and no app. The page works on a phone and on a desktop.
Asking and waiting#
room ask posts the question and blocks until someone replies. Options appear as buttons, and the person can always type an answer of their own. The command prints the reply and anything sent in the few seconds after it, so a tapped answer followed by a typed detail arrives together.
| Command | What it does |
|---|---|
| room <title> | Open a room and print its link. |
| room ask <question> | Post a question and wait for a reply. |
| room say <text> | Post an update without waiting. |
| room wait | Wait for the next reply, or return the replies not seen yet. |
| room listen | Stay in the room and run a command for every message. |
| room read | Print every message in the room. |
| room close | Close the room and stop its billing. |
| room list | List the rooms opened from this machine, with their links. |
Commands use the newest open room unless you name one, as in otterkit room ask hook-7c2e91a4 "Question?". Every command takes --json.
| Flag | Meaning |
|---|---|
--options <list> | ask: answers offered as buttons, comma-separated (up to 6). |
--timeout <duration> | ask and wait: how long to wait, e.g. 90s, 30m, 2h. Default: 30m. |
--agent <name> | room: the name the agent posts under. |
--ttl <duration> | room: close automatically after e.g. 4h, or "never". Default: 24h. |
Getting told when a reply arrives#
An agent only hears a room while something is reading it. The page tells the person which is the case: "is listening and will see your reply right away", or "is not listening right now" with the time it last checked. The agent's face at the top of the room shows the same thing:
There are two ways to keep listening.
Inside a coding agent, run room wait as a background task. It exits as soon as a reply arrives, which hands the reply to the agent, and the agent starts it again after answering:
npx otterkit room wait --timeout 8h --jsonWhen no agent is running, room listen stays in the room and runs a command for every message, so a message can start the agent:
npx otterkit room listen --exec 'claude -p "A person wrote in the OtterKit room: $OTTERKIT_MESSAGE. Answer them with: npx otterkit room say"'The command gets OTTERKIT_MESSAGE, OTTERKIT_MESSAGE_FROM, OTTERKIT_ROOM and OTTERKIT_ROOM_URL in its environment, and the message as JSON on standard input. The text is never placed into the command line, so what a person types cannot change the command that runs. Messages are handled one at a time, in order.
Notifications#
When the agent posts, OtterKit sends a push notification to the devices you have enabled in the console, with the room's title and the message. Tapping it opens the room. Questions always notify; updates notify at most once every 20 seconds. Enable a device once under Notifications in the console↗.
From an MCP client#
The MCP server has the same actions as tools: room_open, room_ask, room_say, room_wait and room_close. An agent in Claude Code or Cursor can open a room and ask you something without you typing a command.
The link is the key#
There is no sign-in. The link ends in 22 random characters, and anyone who has it can read the room and reply. A reply is an instruction to your agent, so share the link only with people you would let direct it. Each person picks a display name, which the agent sees next to their messages; the name is not verified.
Limits and price#
| Limit | Detail |
|---|---|
| Price | 1 credit per hour while the room is open, like a webhook endpoint. |
| Lifetime | Until room close, or the --ttl (24 hours by default). |
| Messages | 1,000 per room, each up to 4,000 characters. |
| Replies | Up to 30 per minute from the page. |
| After closing | The page turns read-only and stops accepting replies. |