Using iMessage with Zhu Li

Zhu Li supports iMessage via BlueBubbles, so you can message your Mac's Apple ID and have Zhu Li respond with Notion-aware context.

Open the Git Integration guide for the commit workflow.

Requirements

• A Mac signed into Messages.app
• BlueBubbles Server installed
• A public Zhu Li URL (or tunnel)

Step 1: Install BlueBubbles

1. Download from bluebubbles.app/downloads
2. Move to Applications and open it
3. If Gatekeeper blocks it, allow it in macOS Privacy & Security

Step 2: Confirm iMessage works

• Open Messages.app and ensure you can send/receive from the Mac

Step 3: Configure BlueBubbles

1. Set a server password
2. Choose Cloudflare Tunnel in the setup wizard
3. Copy the generated public URL

Step 4: Enable Private API

1. BlueBubbles → Settings → Private API Features
2. Run the install script shown in the app
3. Restart Messages.app

Step 5: Add Zhu Li webhook

1. BlueBubbles → Settings → Webhooks
2. Add endpoint:

https://your-zhuli-url/api/v1/channels/bluebubbles/webhook

3. Enable the new-message event

Step 6: Configure Zhu Li dashboard

1. Go to /dashboard/channels
2. Enter BlueBubbles URL + password
3. Save iMessage settings

Step 7: Test

Send any message to the Apple ID on your Mac. You can also use slash commands:

• /issue <description>
• /feature <description>

Troubleshooting

Messages don't arrive

• Re-check webhook URL
• If using ngrok, URL may have changed
• Inspect Zhu Li logs for bluebubbles webhook hits

Zhu Li receives but cannot reply

• Private API is not enabled
• BlueBubbles URL in dashboard doesn't match actual server URL

First reply is slow

• Notion and model cold starts can add several seconds to the first response