@hoverlover/cc-discord 0.2.2 → 0.2.4

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.2",
+  "version": "0.2.4",
   "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,38 +88,8 @@ 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
-
+# Project directory — inherited from start.sh, or derived here for standalone use.
+CLAUDE_PROJECT_DIR="${CC_DISCORD_HOME:-$HOME/.cc-discord}"
 cd "$CLAUDE_PROJECT_DIR"
 echo "[channel-agent:$CHANNEL_NAME] Claude project dir: $CLAUDE_PROJECT_DIR"
 

package/scripts/start.sh

@@ -69,6 +69,30 @@ if $log_setup; then
   echo "[start] Edit .env.relay and .env.worker in that directory, then restart."
 fi
 
+# Project directory for Claude (skills, settings). Exported for channel-agent.sh.
+export CC_DISCORD_HOME="${CC_DISCORD_HOME:-$HOME/.cc-discord}"
+mkdir -p "$CC_DISCORD_HOME/.claude/skills"
+
+# Seed built-in skills from the package into the project directory.
+if [ -d "$ROOT_DIR/.claude/skills" ] && [ "$ROOT_DIR" != "$CC_DISCORD_HOME" ]; then
+  for skill_dir in "$ROOT_DIR/.claude/skills"/*/; do
+    [ -d "$skill_dir" ] || continue
+    skill_name="$(basename "$skill_dir")"
+    if [ ! -d "$CC_DISCORD_HOME/.claude/skills/$skill_name" ]; then
+      cp -r "$skill_dir" "$CC_DISCORD_HOME/.claude/skills/$skill_name"
+      echo "[start] Seeded skill: $skill_name"
+    fi
+  done
+fi
+
+# Seed settings.json so Claude sees project config.
+if [ "$ROOT_DIR" != "$CC_DISCORD_HOME" ] && [ -f "$ROOT_DIR/.claude/settings.template.json" ]; then
+  bash "$ROOT_DIR/scripts/generate-settings.sh"
+  if [ -f "$ROOT_DIR/.claude/settings.json" ]; then
+    cp "$ROOT_DIR/.claude/settings.json" "$CC_DISCORD_HOME/.claude/settings.json"
+  fi
+fi
+
 # Log directory (shared with orchestrator and channel agents)
 export CC_DISCORD_LOG_DIR="${CC_DISCORD_LOG_DIR:-/tmp/cc-discord/logs}"
 mkdir -p "$CC_DISCORD_LOG_DIR"