openqueen · open source

Your coding agent,
controlled by WhatsApp.

Send a message. Gemini compiles it into a task. Claude executes it. You get notified when done, all while you're away from your desk.

Install (30s) View on GitHub ↗

How it works

openqueen · live demo
→ Gemini compiling task... project: ~/signaldash worker: claude done when: grep -q "dark" src/theme.ts → Claude starting...
reading: src/theme.ts editing: src/theme.ts (+47 lines) editing: src/App.tsx (toggle hook) editing: src/components/Navbar.tsx ✓ done when: grep -q "dark" src/theme.ts OK

Architecture  full diagram ↗

You
WhatsApp message from your phone
→
listen.py
Watches group, writes to queue
→
dispatch.py
Compiles NL, routes to project
→
agent.py
Gemini orchestrates workers
→
Claude
Edits code, runs tests, commits
→
You
Proof-first WA notification

Install

1

Install

$ curl -fsSL https://raw.githubusercontent.com/buildingopen/openqueen/main/install.sh | bash
2

Configure

$ openqueen init
→ enter Gemini API key
→ connect WhatsApp (scan QR)
3

Start

$ systemctl enable --now openqueen-listen openqueen-wa

Requires: Python 3.10+, Node.js 18+, git. Tested on Debian/Ubuntu. Runs as a systemd service.

Transport options

Transport Setup Risk Notes
WhatsAppPRIMARY Scan QR code once ToS risk, personal/private use only Baileys library. Group JID filtering. Default transport.
TelegramEXPERIMENTAL Create bot via @BotFather None, official Bot API Add-on transport. No Node.js required.