You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+43-4Lines changed: 43 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -29,7 +29,7 @@
29
29
30
30
## What is OpenWhale?
31
31
32
-
OpenWhale is a **self-extensible AI assistant** that doesn't just chat — it takes action. Connect it to multiple AI models, let it talk on your behalf through WhatsApp/Telegram/Discord/Twitter, browse the web with real browser automation, execute code, manage your calendar, send emails, and basically do whatever you need it to do.
32
+
OpenWhale is a **self-extensible AI assistant** that doesn't just chat — it takes action. Connect it to multiple AI models, let it talk on your behalf through WhatsApp/Telegram/Discord/Twitter/iMessage, browse the web with real browser automation, execute code, manage your calendar, send emails, and basically do whatever you need it to do.
33
33
34
34
Think of it as **Claude, GPT-4, or DeepSeek with arms and legs**.
35
35
@@ -66,7 +66,7 @@ Capable of handling long-running, complex tasks with multi-step reasoning. It pl
66
66
67
67
---
68
68
69
-
### 💬 4 Messaging Channels
69
+
### 💬 5 Messaging Channels
70
70
Your AI responds across all platforms — unified inbox, one brain.
71
71
72
72
| Channel | How it Works |
@@ -75,10 +75,11 @@ Your AI responds across all platforms — unified inbox, one brain.
75
75
|**Telegram**| Create a bot with @BotFather|
76
76
|**Discord**| Add bot to your server |
77
77
|**Twitter/X**| Auto-reply to mentions via bird CLI (cookie auth, no API!) |
78
+
|**iMessage**| macOS native — read and send iMessages via `imsg` CLI |
78
79
79
80
---
80
81
81
-
### 🛠️ 15 Built-in Tools
82
+
### 🛠️ 16 Built-in Tools
82
83
The AI can actually DO things, not just talk about them.
83
84
84
85
| Tool | Capability |
@@ -97,6 +98,7 @@ The AI can actually DO things, not just talk about them.
97
98
|**nodes**| Structured data and knowledge graphs |
98
99
|**camera**| Take photos/video from connected cameras |
99
100
|**location**| Get current geolocation |
101
+
|**imessage**| Read and send iMessages on macOS |
100
102
|**extend**| Create self-extensions for automated workflows |
101
103
102
104
<palign="center">
@@ -207,6 +209,7 @@ Production-ready security out of the box.
207
209
|**Run shell commands**| ✅ Full access | ❌ No | ❌ No | ❌ No |
> ⚠️ **Note:** Twitter/X may rate-limit or flag automated posting. Use with caution on accounts you care about.
440
443
444
+
### iMessage (macOS only)
445
+
446
+
OpenWhale can read and send iMessages natively on macOS using the `imsg` CLI.
447
+
448
+
**Prerequisites:**
449
+
- macOS (iMessage is not available on other platforms)
450
+
- Messages.app signed in with your Apple ID
451
+
- Full Disk Access granted to your terminal (System Settings → Privacy & Security → Full Disk Access)
452
+
- Automation permission for Messages.app
453
+
454
+
**Install imsg CLI:**
455
+
```bash
456
+
brew install steipete/tap/imsg
457
+
```
458
+
459
+
**Via Dashboard:**
460
+
1. Go to `http://localhost:18789/dashboard`
461
+
2. Navigate to **Channels**
462
+
3. Find the **iMessage** card
463
+
4. Click **⬇️ Install imsg CLI** (if not already installed)
464
+
5. Click **📱 Connect iMessage**
465
+
6. Done! The AI can now read and send iMessages
466
+
467
+
**What the AI can do with iMessage:**
468
+
-**List chats** — See your recent iMessage conversations
469
+
-**Read messages** — Read message history from any chat
470
+
-**Send messages** — Send iMessages to any phone number or email
471
+
472
+
**Example prompts:**
473
+
-*"Show me my recent iMessage conversations"*
474
+
-*"Read my latest messages from Mom"*
475
+
-*"Send an iMessage to +1234567890 saying I'll be there in 10 minutes"*
476
+
477
+
> ⚠️ **Note:** iMessage requires macOS. On other platforms, the iMessage card will show as unavailable. The connection persists across server restarts.
478
+
441
479
---
442
480
443
481
## Tools
@@ -460,6 +498,7 @@ These are the built-in capabilities the AI can use. You don't need to configure
460
498
|**nodes**| Work with structured data and knowledge graphs |
461
499
|**camera**| Take photos or record video from connected cameras |
462
500
|**location**| Get current geolocation data |
501
+
|**imessage**| Read and send iMessages on macOS via `imsg` CLI |
463
502
|**extend**| Create self-extensions for automated workflows |
0 commit comments