@hoverlover/cc-discord 0.2.1 → 0.2.3

package/.claude/settings.template.json

@@ -88,6 +88,7 @@
   "permissions": {
     "allow": [
       "Bash(send-discord:*)",
+      "Bash(send-imessage:*)",
       "Bash(wait-for-discord-messages:*)"
     ]
   }

package/.claude/skills/send-imessage/SKILL.md

@@ -0,0 +1,82 @@
+---
+name: send-imessage
+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.
+---
+
+# Send iMessage
+
+Send text messages via macOS Messages.app using the `send-imessage` CLI tool. This skill enables sending iMessages and SMS directly from the Mac.
+
+## When This Skill Applies
+
+- User asks to send a text message or iMessage
+- User asks to text someone (by name, phone number, or Apple ID)
+- User wants to schedule or automate text message delivery
+- User asks about messaging capabilities
+
+## Tool Usage
+
+The `send-imessage` tool is available as a Bash command:
+
+```bash
+send-imessage --to "<recipient>" "<message>"
+```
+
+### Parameters
+
+| Flag | Required | Description |
+|------|----------|-------------|
+| `--to` | Yes | Phone number (10-digit US or with +1) or Apple ID email |
+| `--sms` | No | Force SMS delivery instead of iMessage |
+| `"message"` | Yes | The message text (positional argument) |
+
+### Examples
+
+```bash
+# Send to a US phone number (auto-normalizes to +1)
+send-imessage --to "4175551234" "Hey, just checking in!"
+
+# Send to a number with country code
+send-imessage --to "+14175551234" "Meeting at 3pm"
+
+# Send to an Apple ID email
+send-imessage --to "user@icloud.com" "Hello from Alfred!"
+
+# Force SMS instead of iMessage
+send-imessage --to "4175551234" --sms "This is an SMS"
+```
+
+## Phone Number Handling
+
+The tool auto-normalizes US phone numbers:
+- `4175551234` (10 digits) becomes `+14175551234`
+- `14175551234` (11 digits) becomes `+14175551234`
+- `+14175551234` stays as-is
+- International numbers should include the `+` prefix
+
+## Important Notes
+
+- **macOS only**: This tool uses AppleScript and requires macOS with Messages.app
+- **Apple ID required**: The Mac must be signed into an Apple ID with iMessage enabled
+- **First-run permissions**: macOS may prompt for automation permissions the first time
+- **Delivery**: iMessage is used by default; use `--sms` flag to force SMS
+- **No read receipts**: The tool can only send, not read incoming messages
+- **Rate limiting**: Avoid sending many messages in rapid succession to prevent Apple throttling
+
+## Error Handling
+
+If the send fails:
+1. Check that Messages.app is running and signed in
+2. Verify the recipient phone number or Apple ID is correct
+3. Check that macOS automation permissions are granted for the terminal/process
+4. Try the `--sms` flag if iMessage delivery fails
+
+## Combining with Scheduling
+
+Use cron or systemd timers to schedule messages:
+
+```bash
+# Example: send a daily 9am reminder
+# crontab entry:
+# 0 9 * * * /path/to/tools/send-imessage --to "4175551234" "Good morning! Don't forget your standup."
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hoverlover/cc-discord",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "Discord <-> Claude Code relay: use your Claude subscription to power per-channel AI bots",
   "type": "module",
   "bin": {
@@ -14,6 +14,7 @@
     "prompts/",
     "memory/",
     ".claude/settings.template.json",
+    ".claude/skills/",
     ".env.example",
     ".env.relay.example",
     ".env.worker.example"

package/scripts/channel-agent.sh

@@ -88,6 +88,41 @@ export AGENT_ID="$CHANNEL_ID"
 export CLAUDE_AGENT_ID="${CLAUDE_AGENT_ID:-claude-discord}"
 export CLAUDE_RUNTIME_ID="${CLAUDE_RUNTIME_ID:-rt_$(date +%s)_${RANDOM}}"
 
+# Determine Claude's project directory (where .claude/skills/ are discovered).
+# - CC_DISCORD_HOME overrides everything
+# - If cwd has a .claude/ directory (local dev / bun start from repo), use cwd
+# - Otherwise default to ~/.cc-discord (bunx / installed package)
+if [ -n "${CC_DISCORD_HOME:-}" ]; then
+  CLAUDE_PROJECT_DIR="$CC_DISCORD_HOME"
+elif [ -d ".claude" ]; then
+  CLAUDE_PROJECT_DIR="$(pwd)"
+else
+  CLAUDE_PROJECT_DIR="$HOME/.cc-discord"
+fi
+
+mkdir -p "$CLAUDE_PROJECT_DIR/.claude/skills"
+
+# Seed built-in skills from the package into the project directory.
+# Only copies skills that don't already exist (user modifications are preserved).
+if [ -d "$ROOT_DIR/.claude/skills" ] && [ "$ROOT_DIR" != "$CLAUDE_PROJECT_DIR" ]; then
+  for skill_dir in "$ROOT_DIR/.claude/skills"/*/; do
+    skill_name="$(basename "$skill_dir")"
+    if [ ! -d "$CLAUDE_PROJECT_DIR/.claude/skills/$skill_name" ]; then
+      cp -r "$skill_dir" "$CLAUDE_PROJECT_DIR/.claude/skills/$skill_name"
+      echo "[channel-agent:$CHANNEL_NAME] Seeded skill: $skill_name"
+    fi
+  done
+fi
+
+# Copy settings.json into the project dir so Claude sees it as a project config.
+if [ "$ROOT_DIR" != "$CLAUDE_PROJECT_DIR" ] && [ -f "$SETTINGS_PATH" ]; then
+  mkdir -p "$CLAUDE_PROJECT_DIR/.claude"
+  cp "$SETTINGS_PATH" "$CLAUDE_PROJECT_DIR/.claude/settings.json"
+fi
+
+cd "$CLAUDE_PROJECT_DIR"
+echo "[channel-agent:$CHANNEL_NAME] Claude project dir: $CLAUDE_PROJECT_DIR"
+
 # Build the channel-specific system prompt
 SYSTEM_PROMPT="$(sed \
   -e "s|__CHANNEL_ID__|${CHANNEL_ID}|g" \

package/tools/send-imessage

@@ -0,0 +1,2 @@
+#!/bin/sh
+exec bun "$(dirname "$0")/send-imessage.ts" "$@"

package/tools/send-imessage.ts

@@ -0,0 +1,96 @@
+#!/usr/bin/env bun
+
+/**
+ * Send an iMessage via macOS Messages.app using AppleScript.
+ *
+ * Usage:
+ *   send-imessage --to "+14175551234" "Hello from Alfred!"
+ *   send-imessage --to "+14175551234" --sms "This goes as SMS"
+ *   send-imessage --to "user@icloud.com" "Hello via Apple ID"
+ */
+
+import { $ } from "bun";
+
+const args = process.argv.slice(2);
+let to: string | null = null;
+let useSms = false;
+const textParts: string[] = [];
+
+for (let i = 0; i < args.length; i++) {
+  const arg = args[i];
+  if (arg === "--to" && args[i + 1]) {
+    to = args[++i];
+    continue;
+  }
+  if (arg === "--sms") {
+    useSms = true;
+    continue;
+  }
+  if (arg === "--help" || arg === "-h") {
+    console.log(`
+Usage: send-imessage --to <phone_or_appleid> [--sms] "message"
+
+Options:
+  --to    Phone number (with country code, e.g. +14175551234) or Apple ID email
+  --sms   Force SMS instead of iMessage (uses SMS service)
+
+Examples:
+  send-imessage --to "+14175551234" "Hello!"
+  send-imessage --to "user@icloud.com" "Hey there"
+  send-imessage --to "+14175551234" --sms "SMS fallback"
+`);
+    process.exit(0);
+  }
+  textParts.push(arg);
+}
+
+const message = textParts.join(" ").trim();
+
+if (!to) {
+  console.error("Error: --to is required. Use --help for usage.");
+  process.exit(1);
+}
+
+if (!message) {
+  console.error("Error: message text is required. Use --help for usage.");
+  process.exit(1);
+}
+
+// Normalize phone number: ensure it starts with +1 if it's a 10-digit US number
+let normalizedTo = to;
+if (/^\d{10}$/.test(to)) {
+  normalizedTo = `+1${to}`;
+} else if (/^1\d{10}$/.test(to)) {
+  normalizedTo = `+${to}`;
+}
+
+// Escape single quotes for AppleScript
+const escapedMessage = message.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+const escapedTo = normalizedTo.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+
+// Build AppleScript
+const serviceFilter = useSms
+  ? 'service type = SMS'
+  : 'service type = iMessage';
+
+const script = `tell application "Messages" to send "${escapedMessage}" to buddy "${escapedTo}" of (1st service whose ${serviceFilter})`;
+
+try {
+  const result = await $`osascript -e ${script}`.quiet();
+
+  if (result.exitCode !== 0) {
+    const stderr = result.stderr.toString().trim();
+    console.error(`Failed to send iMessage: ${stderr}`);
+    process.exit(1);
+  }
+
+  console.log(`iMessage sent to ${normalizedTo}: "${message}"`);
+  process.exit(0);
+} catch (err: unknown) {
+  const error = err as Error & { stderr?: Buffer };
+  const stderr = error.stderr?.toString().trim() || error.message;
+  console.error(`Failed to send iMessage: ${stderr}`);
+  process.exit(1);
+}
+
+export {};