session-planner 1.1.1 → 1.1.5

package/.claude-plugin/marketplace.json

@@ -0,0 +1,11 @@
+{
+  "name": "MahmoudMabrok Marketplace",
+  "description": "Custom Claude Code plugins by MahmoudMabrok",
+  "plugins": [
+    {
+      "name": "session-planner",
+      "description": "Schedule Hello! Claude Code sessions",
+      "source": "."
+    }
+  ]
+}

package/.claude-plugin/plugin.json

@@ -0,0 +1,10 @@
+{
+  "name": "session-planner",
+  "version": "1.1.1",
+  "description": "Schedule Hello! Claude Code sessions to maximize session duration.",
+  "commands": [
+    "./commands/hello.md",
+    "./commands/hello-list.md",
+    "./commands/hello-remove.md"
+  ]
+}

package/README.md

@@ -116,6 +116,17 @@ scripts/hello-scheduler.sh   (bash)
 | **Claude Code** | `claude` in PATH — [install](https://code.claude.com) |
 | **cron** | Built-in on macOS; Linux: `sudo apt install cron` |
 | **Bash** 4+ | macOS: `brew install bash` |
+| **OS Support** | macOS and Linux (terminal use) |
+
+---
+
+## 🔐 Permissions (macOS)
+
+To ensure `session-planner` can schedule jobs and show notifications without prompting every time, grant your terminal (Terminal or iTerm) the following:
+
+1. **Full Disk Access**: Go to `System Settings > Privacy & Security > Full Disk Access` and add your terminal. This is required for `crontab` to save your schedule.
+2. **Notifications**: Go to `System Settings > Notifications > Script Editor` and ensure "Allow Notifications" is on.
+
 
 Logs: `~/.claude/session-planner.log`
 
@@ -125,9 +136,11 @@ Logs: `~/.claude/session-planner.log`
 
 ```
 SessionPlanner/
-├── hello-scheduler.sh             ← core scheduling logic
+├── scripts/
+│   └── hello-scheduler.sh         ← core scheduling logic
+├── commands/
+│   └── hello.md                   ← command definition
 ├── session-planner.js             ← npx / global CLI entry
-├── {hello,hello-list,hello-remove}.md  ← command definitions
 ├── package.json
 └── README.md
 ```

package/{hello-list.md → commands/hello-list.md}

@@ -5,6 +5,6 @@ allowed-tools: Bash
 
 List all scheduled hello sessions:
 
-!`bash ~/.claude/scripts/hello-scheduler.sh --list`
+!`bash ${CLAUDE_PLUGIN_ROOT}/scripts/hello-scheduler.sh --list`
 
 Present the output as a clean table to the user. If no jobs are found, let them know and suggest running `/hello <time>` to schedule one.

package/{hello-remove.md → commands/hello-remove.md}

@@ -7,9 +7,9 @@ allowed-tools: Bash
 The user wants to remove a scheduled hello session. Their argument is: $ARGUMENTS
 
 If the argument is "--all" or "all":
-!`bash ~/.claude/scripts/hello-scheduler.sh --remove-all`
+!`bash ${CLAUDE_PLUGIN_ROOT}/scripts/hello-scheduler.sh --remove-all`
 
 Otherwise treat $ARGUMENTS as a time and run:
-!`bash ~/.claude/scripts/hello-scheduler.sh --remove $ARGUMENTS`
+!`bash ${CLAUDE_PLUGIN_ROOT}/scripts/hello-scheduler.sh --remove $ARGUMENTS`
 
 Confirm to the user what was removed.

package/{hello.md → commands/hello.md}

@@ -10,7 +10,7 @@ The user wants to schedule hello sessions. Their arguments are: $ARGUMENTS
 
 Execute the scheduler script:
 
-!`bash ~/.claude/scripts/hello-scheduler.sh $ARGUMENTS`
+!`bash ${CLAUDE_PLUGIN_ROOT}/scripts/hello-scheduler.sh $ARGUMENTS`
 
 ## Step 2 — Parse the output and report
 
@@ -52,4 +52,4 @@ Tell the user:
 2. The offset used (e.g. "4 hours before each target time")
 3. That persistent cron jobs have been registered (survive terminal close)
 4. That the `/loop` in-session reminder was set for the soonest session
-5. How to list or remove jobs: `crontab -l` / `~/.claude/scripts/hello-scheduler.sh --list` / `--remove-all`
+5. How to list or remove jobs: `crontab -l` / `${CLAUDE_PLUGIN_ROOT}/scripts/hello-scheduler.sh --list` / `--remove-all`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "session-planner",
-  "version": "1.1.1",
+  "version": "1.1.5",
   "description": "Schedule Hello! Claude Code sessions at specific times. Opens a session N hours before your chosen time.",
   "keywords": [
     "claude",
@@ -25,16 +25,19 @@
   "engines": {
     "node": ">=14.0.0"
   },
+  "os": [
+    "darwin",
+    "linux"
+  ],
   "scripts": {
     "test": "bash tests/test-parse.sh"
   },
   "files": [
-    "hello-scheduler.sh",
+    "scripts/hello-scheduler.sh",
+    "commands/",
+    ".claude-plugin/",
     "session-planner.js",
-    "hello.md",
-    "hello-list.md",
-    "hello-remove.md",
     "README.md",
     "LICENSE"
   ]
-}
+}

package/{hello-scheduler.sh → scripts/hello-scheduler.sh}

@@ -103,7 +103,9 @@ parse_time() {
     error "Unrecognised time format: '$1'. Try: 1am  2:30pm  14:00"
   fi
 
-  [[ $PARSED_HOUR -gt 23 ]] && error "Hour out of range 0-23 (got: $1)"
+  if [[ $PARSED_HOUR -gt 23 ]]; then
+    error "Hour out of range 0-23 (got: $1)"
+  fi
 }
 
 # 24h hour+min → pretty 12h string
@@ -117,6 +119,16 @@ pretty_time() {
   printf "%d:%02d %s" $ph $m $suffix
 }
 
+send_notification() {
+  local msg="$1"
+  local title="Session Planner"
+  if [[ "$OSTYPE" == "darwin"* ]]; then
+    osascript -e "display notification \"$msg\" with title \"$title\""
+  elif command -v notify-send >/dev/null; then
+    notify-send "$title" "$msg"
+  fi
+}
+
 # Seconds until next occurrence of HH:MM (today or tomorrow)
 seconds_until() {
   local th=$1 tm=$2
@@ -130,7 +142,9 @@ seconds_until() {
 
 # ── argument parsing ──────────────────────────────────────────────────────────
 
-[[ $# -eq 0 ]] && usage
+if [[ $# -eq 0 ]]; then
+  usage
+fi
 
 while [[ $# -gt 0 ]]; do
   case "$1" in
@@ -158,8 +172,8 @@ done
 
 if $LIST_MODE; then
   echo -e "${BOLD}Scheduled Hello jobs:${RESET}"
-  if crontab -l 2>/dev/null | grep -q "# session-planner"; then
-    crontab -l 2>/dev/null | grep "# session-planner"
+  if (((crontab -l 2>/dev/null || true) || true) || true) | grep -q "# session-planner"; then
+    (((crontab -l 2>/dev/null || true) || true) || true) | grep "# session-planner"
   else
     echo -e "  ${YELLOW}No session-planner jobs found.${RESET}"
   fi
@@ -170,11 +184,11 @@ fi
 
 if $REMOVE_ALL; then
   tmp=$(mktemp)
-  crontab -l 2>/dev/null \
+  ((crontab -l 2>/dev/null || true) || true) \
     | grep -v "# session-planner" \
     | grep -v "session-planner" \
     > "$tmp" || true
-  crontab "$tmp"; rm -f "$tmp"
+  cat "$tmp" | crontab -; rm -f "$tmp"
   echo -e "${GREEN}✓${RESET} All session-planner jobs removed."
   exit 0
 fi
@@ -185,28 +199,33 @@ if [[ -n "$REMOVE_TIME" ]]; then
   parse_time "$REMOVE_TIME"
   TARGET_PRETTY=$(pretty_time "$PARSED_HOUR" "$PARSED_MIN")
   tmp=$(mktemp)
-  crontab -l 2>/dev/null \
+  ((crontab -l 2>/dev/null || true) || true) \
     | grep -v "# session-planner.*${TARGET_PRETTY}" \
     | grep -v "Hello! It is now ${TARGET_PRETTY}" \
     > "$tmp" || true
-  crontab "$tmp"; rm -f "$tmp"
+  cat "$tmp" | crontab -; rm -f "$tmp"
   echo -e "${GREEN}✓${RESET} Removed session-planner job for ${BOLD}${TARGET_PRETTY}${RESET}."
   exit 0
 fi
 
 # ── validate at least one time was given ─────────────────────────────────────
 
-[[ ${#TIMES[@]} -eq 0 ]] && error "Please provide at least one time. E.g: hello-scheduler.sh 1am"
+if [[ ${#TIMES[@]} -eq 0 ]]; then
+  error "Please provide at least one time. E.g: hello-scheduler.sh 1am"
+fi
 
 # ── ensure log dir ────────────────────────────────────────────────────────────
 
 mkdir -p "$HOME/.claude"
 LOG="$HOME/.claude/session-planner.log"
 
+# ── find claude path for cron ──────────────────────────────────────────────────
+CLAUDE_PATH=$(which claude 2>/dev/null || echo "claude")
+
 # ── load crontab, strip existing session-planner entries ─────────────────────
 
 tmp=$(mktemp)
-crontab -l 2>/dev/null \
+((crontab -l 2>/dev/null || true) || true) \
   | grep -v "# session-planner" \
   | grep -v "session-planner" \
   > "$tmp" || true
@@ -233,10 +252,11 @@ for T in "${TIMES[@]}"; do
   TARGET_PRETTY=$(pretty_time "$TARGET_H" "$TARGET_M")
   SCHED_PRETTY=$(pretty_time "$SCHED_H" "$SCHED_M")
 
-  # cron job: claude --print fires at session-open time
+  # cron job: claude --print fires at session-open time + notification
   MSG="Hello! It is now ${TARGET_PRETTY}. This is your scheduled greeting."
   CRON_EXPR="${SCHED_M} ${SCHED_H} * * *"
-  CRON_LINE="${CRON_EXPR} claude --print \"${MSG}\" >> ${LOG} 2>&1"
+  # We use a subshell for the notification to handle the environment/osascript better
+  CRON_LINE="${CRON_EXPR} ${CLAUDE_PATH} --print \"${MSG}\" >> ${LOG} 2>&1; if [ \"\$(uname)\" = \"Darwin\" ]; then osascript -e \"display notification \\\"${MSG}\\\" with title \\\"Session Planner\\\"\"; elif command -v notify-send >/dev/null; then notify-send \"Session Planner\" \"${MSG}\"; fi"
 
   {
     echo "# session-planner: session at ${SCHED_PRETTY} → greeting at ${TARGET_PRETTY} (offset: ${OFFSET_HOURS}h)"
@@ -252,6 +272,9 @@ for T in "${TIMES[@]}"; do
     SOONEST_SESSION="$SCHED_PRETTY"
   fi
 
+  # Success message for user
+  echo -e "${GREEN}✓${RESET} Scheduled Claude session to start at ${BOLD}${SCHED_PRETTY}${RESET} (greeting at ${TARGET_PRETTY})"
+
   # Structured output for Claude to parse
   echo "SCHEDULED: {\"target\":\"${TARGET_PRETTY}\",\"session_at\":\"${SCHED_PRETTY}\",\"cron\":\"${CRON_EXPR}\",\"loop_in_seconds\":${LOOP_SECS},\"offset_hours\":${OFFSET_HOURS}}"
 
@@ -263,7 +286,7 @@ done
 JOBS_JSON+="]"
 
 # Commit updated crontab
-crontab "$tmp"
+cat "$tmp" | crontab -
 rm -f "$tmp"
 
 # Summary for Claude's confirmation message

package/session-planner.js

@@ -21,6 +21,14 @@ const path = require('path');
 const fs = require('fs');
 const os = require('os');
 
+// ── OS Compatibility Check ───────────────────────────────────────────────────
+if (process.platform === 'win32') {
+  console.error('\x1b[31mERROR:\x1b[0m session-planner currently only supports macOS and Linux.');
+  console.error('This tool relies on bash and cron, which are not natively available on Windows.');
+  process.exit(1);
+}
+
+
 // ── colours ───────────────────────────────────────────────────────────────────
 const isTTY = process.stdout.isTTY;
 const c = {
@@ -38,6 +46,7 @@ const c = {
 //   2. Installed as a Claude Code plugin  ~/.claude/plugins/session-planner/scripts/
 function findScript() {
   const candidates = [
+    path.join(__dirname, 'scripts', 'hello-scheduler.sh'),
     path.join(__dirname, 'hello-scheduler.sh'),
     path.join(os.homedir(), '.claude', 'plugins', 'session-planner', 'scripts', 'hello-scheduler.sh'),
   ];