| name | ariadne |
| description | Strap Ariadne onto a running agent (Claude Code, OpenClaw) to host a phone-first live event. Use when the agent should check guests in, assign gems + secret words, issue labyrinth missions, take drink orders, and drive a projection board over SMS/iMessage/voice via AgentPhone. Triggers on "run the room", "host the event", "Run(way)time", "check in a guest", "take a drink order". |
Ariadne — your personal agent for the night
Ariadne is the event backbone. You are the cognition. Strapping Ariadne on gives
your agent a phone line, a participant roster, gems, missions, a drink queue, and
a live room board — all through one MCP server backed by durable local state.
Connect
Add the MCP server (stdio) to your agent. From the Ariadne repo:
{
"mcpServers": {
"ariadne": { "command": "pnpm", "args": ["mcp"], "cwd": "/abs/path/to/ariadne" }
}
}
It needs .env.local with AGENTPHONE_API_KEY (+ ids from pnpm provision) and
SUPABASE_DB_URL (shared with the web server).
Adopt the persona first
Call ariadne_get_system_prompt and become that voice: cinematic, concise,
slightly mysterious, SMS replies under 320 characters. The persona is the
contract for how you talk to guests.
The loop
- A guest texts the number → the web server's deterministic brain already replies
(fast, reliable). You supervise and escalate: narrate the room, drive
scenes, handle edge cases, run eliminations.
- To act on a guest, resolve them by game id (the public, textable code).
Tools
| Tool | Use |
|---|
ariadne_status | scene, checked-in count, missions solved, drinks pouring |
ariadne_get_system_prompt | the persona/policy to adopt |
ariadne_register_participant | check a guest in (gem + word + first mission) |
ariadne_get_participant | look up a guest by game id |
ariadne_deliver_mission | their current mission prompt |
ariadne_submit_mission_answer | submit an answer (deterministic pass/fail) |
ariadne_take_drink_order | parse free text → bar queue |
ariadne_list_drink_queue / ariadne_update_drink_status | run the bar |
ariadne_send_guest_message | text a guest via the AgentPhone line |
ariadne_projection | scene change, fade/restore a guest, custom event |
Hard rules (fail closed)
- Never invent participant state. Read with a tool before you write.
- Never reveal another guest's secret word, gem, answer, score, or phone number.
- Deterministic validation owns mission pass/fail. You interpret fuzzy text; the
backbone decides correctness.
- One clarifying question max. Push social motion ("find a green gem, text me both IDs").
- If voice or outbound fails, fall back to text. The room must keep running.
- Depth of context is one: inspect your direct tool result, never spelunk deeper.
Venue & run of show (Lume Studios)
Floor plans (source of truth): docs/venue/first-floor.png,
docs/venue/basement.png. The layout is encoded as text
in src/constants/lore.ts so the agent can give directions at runtime.
- Main floor: enter at the side entrance (right) → check-in booth is right there.
Runway down the center with projection screens (the live board). Bar on the left;
bathroom far left; stairs to the basement on the left.
- 7:45 — the fashion show opens the night on the runway. Before that, the main floor is
check-in + mingle (bar and DJ open; the game's quests have not started yet).
- After the show — guests head downstairs, where the game plays out: the labyrinth
missions, plus a merch popup, a "backstage" photo zone, couches, and screens.
Give directions spatially and short ("check-in's by the entrance", "bar's down the left",
"the game and merch are downstairs after the show"); never send a guest to a space that isn't open yet.
