@hoverlover/cc-discord 0.2.2 → 0.2.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,82 @@
1
+ ---
2
+ name: send-imessage
3
+ description: Use when the user asks to "send a text", "send an iMessage", "text someone", "send a message to [phone number]", "message [person]", or discusses sending SMS/iMessage. Also use when scheduling text messages or automating iMessage delivery.
4
+ ---
5
+
6
+ # Send iMessage
7
+
8
+ Send text messages via macOS Messages.app using the `send-imessage` CLI tool. This skill enables sending iMessages and SMS directly from the Mac.
9
+
10
+ ## When This Skill Applies
11
+
12
+ - User asks to send a text message or iMessage
13
+ - User asks to text someone (by name, phone number, or Apple ID)
14
+ - User wants to schedule or automate text message delivery
15
+ - User asks about messaging capabilities
16
+
17
+ ## Tool Usage
18
+
19
+ The `send-imessage` tool is available as a Bash command:
20
+
21
+ ```bash
22
+ send-imessage --to "<recipient>" "<message>"
23
+ ```
24
+
25
+ ### Parameters
26
+
27
+ | Flag | Required | Description |
28
+ |------|----------|-------------|
29
+ | `--to` | Yes | Phone number (10-digit US or with +1) or Apple ID email |
30
+ | `--sms` | No | Force SMS delivery instead of iMessage |
31
+ | `"message"` | Yes | The message text (positional argument) |
32
+
33
+ ### Examples
34
+
35
+ ```bash
36
+ # Send to a US phone number (auto-normalizes to +1)
37
+ send-imessage --to "4175551234" "Hey, just checking in!"
38
+
39
+ # Send to a number with country code
40
+ send-imessage --to "+14175551234" "Meeting at 3pm"
41
+
42
+ # Send to an Apple ID email
43
+ send-imessage --to "user@icloud.com" "Hello from Alfred!"
44
+
45
+ # Force SMS instead of iMessage
46
+ send-imessage --to "4175551234" --sms "This is an SMS"
47
+ ```
48
+
49
+ ## Phone Number Handling
50
+
51
+ The tool auto-normalizes US phone numbers:
52
+ - `4175551234` (10 digits) becomes `+14175551234`
53
+ - `14175551234` (11 digits) becomes `+14175551234`
54
+ - `+14175551234` stays as-is
55
+ - International numbers should include the `+` prefix
56
+
57
+ ## Important Notes
58
+
59
+ - **macOS only**: This tool uses AppleScript and requires macOS with Messages.app
60
+ - **Apple ID required**: The Mac must be signed into an Apple ID with iMessage enabled
61
+ - **First-run permissions**: macOS may prompt for automation permissions the first time
62
+ - **Delivery**: iMessage is used by default; use `--sms` flag to force SMS
63
+ - **No read receipts**: The tool can only send, not read incoming messages
64
+ - **Rate limiting**: Avoid sending many messages in rapid succession to prevent Apple throttling
65
+
66
+ ## Error Handling
67
+
68
+ If the send fails:
69
+ 1. Check that Messages.app is running and signed in
70
+ 2. Verify the recipient phone number or Apple ID is correct
71
+ 3. Check that macOS automation permissions are granted for the terminal/process
72
+ 4. Try the `--sms` flag if iMessage delivery fails
73
+
74
+ ## Combining with Scheduling
75
+
76
+ Use cron or systemd timers to schedule messages:
77
+
78
+ ```bash
79
+ # Example: send a daily 9am reminder
80
+ # crontab entry:
81
+ # 0 9 * * * /path/to/tools/send-imessage --to "4175551234" "Good morning! Don't forget your standup."
82
+ ```
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@hoverlover/cc-discord",
3
- "version": "0.2.2",
3
+ "version": "0.2.3",
4
4
  "description": "Discord <-> Claude Code relay: use your Claude subscription to power per-channel AI bots",
5
5
  "type": "module",
6
6
  "bin": {
@@ -14,6 +14,7 @@
14
14
  "prompts/",
15
15
  "memory/",
16
16
  ".claude/settings.template.json",
17
+ ".claude/skills/",
17
18
  ".env.example",
18
19
  ".env.relay.example",
19
20
  ".env.worker.example"