dsh-bluebubbles

On macOS, iMessage is often the primary communication channel, yet DeepSeek Harness agent sessions are locked behind a terminal. dsh-bluebubbles bridges a local BlueBubbles server (the iMessage HTTP bridge) into DSH, so a single text message can wake an agent, let it read context, run tasks, and send results back to the chat window -- all without opening a Web UI.

The plugin follows a minimal-host principle: the host keeps only passive capabilities (webhook receive, binding resolution, message injection) plus two high-frequency model tools (send_text and send_attachment). Everything else is consolidated into the bb-channel CLI, which agents call via bash and humans or automation scripts can invoke directly. The bundled dsh-heartbeat provides periodic wake-up, dsh-cron supports scheduled job triggers, and both share the same relay auto-delivery mechanism -- assistant text replies are pushed back to iMessage immediately while thinking and tool results are filtered out.

To handle headless scenarios where no one is watching a web UI, the plugin ships a guard layer: ask_user_question is converted to a plain-text follow-up, and approval requests default to reject (fail closed), ensuring a purely iMessage-driven session never parks forever. A two-layer anti-loop mechanism (pendingSent queue plus seenGuids set) prevents the agent from receiving its own outbound messages as webhook echoes.

Ideal for macOS developers and tinkerers who live in iMessage and want to drive AI agents with a single text message for development work or everyday tasks.