opendick

---

[!IMPORTANT] This controls a physical device on a real person. Use it only with the enthusiastic, ongoing consent of the person wearing it. Keep the safety cap sane, prefer short durations, and keep an emergency stop within reach. See Safety & consent.

What it is

  ┌──────────────┐   MCP (stdio)    ┌───────────────────────────┐
  │  Claude Code │ ───────────────► │          opendick         │
  └──────────────┘                  │  (one process)            │
  ┌──────────────┐   WebSocket      │   ┌─────────────────────┐ │
  │  Web console │ ◄──────────────► │   │   DeviceManager     │ │  safety cap · watchdog
  │  + master    │                  │   │   ModeController    │ │  patterns · video · game
  └──────────────┘                  │   └──────────┬──────────┘ │
                                    └──────────────┼────────────┘
                                       ┌───────────┴───────────┐
                                       ▼                       ▼
                              buttplug backend          simulated backend
                          → Intiface → real toy         (preview, no hardware)

One process is both the MCP server Claude talks to and the web console you watch — so the chat and the dashboard always share the exact same device state.

• 🔌 Real hardware. Drives Lovense, We-Vibe, Kiiroo, The Handy, Satisfyer, and 750+ devices through Intiface Central.
• 👑 Master remote. A focused phone-friendly control page (/master) so another person can take control in real time — big dial, hold-to-buzz, presets, emergency stop. Every page shows when a master is in control.
• 🎬 Video mode. Plays a Funscript timeline in real time (position 0..100 → intensity).
• 🎮 Game mode. Built-in engines — roulette, escalation, ambient — plus a game_event hook so Claude can react inside a text adventure ("you found treasure → reward").
• 🎵 Audio mode. Drives the device from your microphone or tab/system audio in real time (music, voice, a video's soundtrack) via the browser's Web Audio.
• ⚡ Reactive "Pulse Core" UI. A breathing energy orb and an aurora background that glow, scale and pulse with live intensity, plus a real-time audio waveform — not a boring dashboard.
• 🌐 Bilingual. Console and master remote ship in English and 中文 with a one-tap toggle.
• 🧪 Simulator (preview). No hardware? A fake device the console visualises as a pulsing, buzzing motor — build and demo everything for free.
• 🛟 Safety, built in. Global max-intensity cap, per-command auto-stop, a watchdog that kills the motor if a driver stops feeding, an emergency stop everywhere, and hardware-off on exit.

Install (as a Claude Code plugin)

# 1. add this repo as a plugin marketplace
/plugin marketplace add SimonAKing/opendick

# 2. install the plugin
/plugin install opendick@opendick

The MCP server (a self-contained bundle, no node_modules needed) and the slash commands are now available. Open a chat and try:

scan for devices
vibrate at 40% for 3 seconds
run the "wave" pattern twice
start an ambient game for 30 seconds
set the safety max to 60%
stop everything

The console comes up at http://localhost:8731 — run /opendick:console to open it.

Slash commands

command	what it does
/opendick:console	open the live web console in your browser
/opendick:demo	run a short scan → vibrate → pattern → game demo
/opendick:panic	emergency stop — everything off, now

Connect a real device

opendick is built for real hardware first; the simulator is just a preview.