@wonsukchoi/crondex 0.1.0 → 0.1.1

package/README.md

@@ -18,21 +18,35 @@ adjusts `schedule`/`variables`, and wires it into whatever scheduler it has.
 
 ## CLI
 
-Not yet published to the npm registry, so `npx crondex` doesn't resolve
-publicly yet — for now, run it from a clone:
+Published on npm as `@wonsukchoi/crondex` (the plain name `crondex` was
+blocked by npm's anti-typosquat check). The command itself is still
+`crondex` once installed — only the package name is scoped:
 
 ```bash
-git clone https://github.com/wonsukchoi/crondex.git && cd crondex
-node bin/crondex.js list                          # browse everything
-node bin/crondex.js list --category devops        # filter by category or --tag
-node bin/crondex.js show backup-reminder          # print one job's YAML
-node bin/crondex.js add backup-reminder --dest ./cron/backup-reminder.yaml
+npx @wonsukchoi/crondex list                          # browse everything
+npx @wonsukchoi/crondex list --category devops        # filter by category or --tag
+npx @wonsukchoi/crondex show backup-reminder          # print one job's YAML
+npx @wonsukchoi/crondex add backup-reminder --dest ./cron/backup-reminder.yaml
+```
+
+Or install once and drop the scope prefix on every call:
+
+```bash
+npm install -g @wonsukchoi/crondex
+crondex list
 ```
 
 `add` copies the job's YAML as-is into your project — it's yours to edit
-from there, same as a `git clone` + copy, just one command. Once this is
-published, the same commands work via `npx crondex ...` with no clone
-needed.
+from there. `npx` always pulls the latest published catalog; a global
+install needs `npm update -g @wonsukchoi/crondex` to see new jobs (`crondex
+list` prints a reminder either way).
+
+A clone works too, no npm required:
+
+```bash
+git clone https://github.com/wonsukchoi/crondex.git && cd crondex
+node bin/crondex.js list
+```
 
 ## Layout
 
@@ -43,7 +57,8 @@ crondex/
 ├── schema/job.schema.json spec every job file follows
 ├── jobs/
 │   ├── devops/
-│   └── productivity/
+│   ├── productivity/
+│   └── personal/
 └── scripts/
     ├── build-catalog.js   regenerates catalog.json from jobs/**/*.yaml
     └── validate-jobs.js   validates every job against the schema
@@ -63,6 +78,9 @@ crondex/
 | `daily-standup-summary` | productivity | `0 8 * * 1-5` | script + agent-prompt |
 | `inbox-triage` | productivity | `0 7,13 * * 1-5` | agent-prompt only |
 | `weekly-report` | productivity | `0 16 * * 5` | script + agent-prompt |
+| `bill-due-reminder` | personal | `0 9 * * *` | script |
+| `habit-checkin` | personal | `0 20 * * *` | script |
+| `meal-plan-reminder` | personal | `0 9 * * 0` | script + agent-prompt |
 
 Full details (description, tags, variables) live in `catalog.json` and each
 job's YAML file.

package/bin/crondex.js

@@ -42,7 +42,7 @@ function catalogInfoLine() {
   const viaNpx = process.env.npm_command === "exec";
   const freshness = viaNpx
     ? "running via npx — you're always on the latest catalog."
-    : "running from a local/global install — run `npm update -g crondex` (or re-pull) if new jobs seem missing.";
+    : `running from a local/global install — run \`npm update -g ${PKG.name}\` (or re-pull) if new jobs seem missing.`;
   return `crondex v${PKG.version} — ${CATALOG.count} jobs. ${freshness}`;
 }
 

package/catalog.json

@@ -1,7 +1,7 @@
 {
   "generated_by": "scripts/build-catalog.js",
   "schema": "schema/job.schema.json",
-  "count": 10,
+  "count": 13,
   "jobs": [
     {
       "id": "backup-reminder",
@@ -27,6 +27,30 @@
       ],
       "path": "jobs/devops/backup-reminder.yaml"
     },
+    {
+      "id": "bill-due-reminder",
+      "version": 1,
+      "name": "Bill Due Reminder",
+      "description": "Warns you a few days before a recurring monthly bill is due. Use this if you've ever paid a late fee just because you forgot the date.",
+      "category": "personal",
+      "tags": [
+        "bills",
+        "finance",
+        "reminder"
+      ],
+      "schedule": "0 9 * * *",
+      "timezone": "America/Los_Angeles",
+      "runner": "shell",
+      "modes": [
+        "script"
+      ],
+      "compatible_agents": [
+        "generic",
+        "claude",
+        "codex"
+      ],
+      "path": "jobs/personal/bill-due-reminder.yaml"
+    },
     {
       "id": "cost-alert",
       "version": 1,
@@ -108,6 +132,30 @@
       ],
       "path": "jobs/devops/dependency-audit.yaml"
     },
+    {
+      "id": "habit-checkin",
+      "version": 1,
+      "name": "Daily Habit Check-in",
+      "description": "Reminds you to log a habit each day and reports your current streak. Use this if you're trying to build a habit and want a daily nudge plus a running streak count without a separate app.",
+      "category": "personal",
+      "tags": [
+        "habit",
+        "streak",
+        "reminder"
+      ],
+      "schedule": "0 20 * * *",
+      "timezone": "America/Los_Angeles",
+      "runner": "shell",
+      "modes": [
+        "script"
+      ],
+      "compatible_agents": [
+        "generic",
+        "claude",
+        "codex"
+      ],
+      "path": "jobs/personal/habit-checkin.yaml"
+    },
     {
       "id": "inbox-triage",
       "version": 1,
@@ -157,6 +205,33 @@
       ],
       "path": "jobs/devops/log-cleanup.yaml"
     },
+    {
+      "id": "meal-plan-reminder",
+      "version": 1,
+      "name": "Weekly Meal Plan Reminder",
+      "description": "Nudges you to plan the week's meals, and can draft a simple 7-day plan plus grocery list for you. Use this if you dread the \"what's for dinner\" question every night and want to decide once a week instead.",
+      "category": "personal",
+      "tags": [
+        "meals",
+        "planning",
+        "household"
+      ],
+      "schedule": "0 9 * * 0",
+      "timezone": "America/Los_Angeles",
+      "runner": "hybrid",
+      "modes": [
+        "script",
+        "agent-prompt"
+      ],
+      "compatible_agents": [
+        "claude",
+        "codex",
+        "hermes",
+        "openclaw",
+        "generic"
+      ],
+      "path": "jobs/personal/meal-plan-reminder.yaml"
+    },
     {
       "id": "repo-health-check",
       "version": 1,

package/jobs/personal/bill-due-reminder.yaml

@@ -0,0 +1,32 @@
+id: bill-due-reminder
+version: 1
+name: Bill Due Reminder
+description: >
+  Warns you a few days before a recurring monthly bill is due. Use this if
+  you've ever paid a late fee just because you forgot the date.
+category: personal
+tags: [bills, finance, reminder]
+schedule: "0 9 * * *"
+timezone: "America/Los_Angeles"
+runner: shell
+command: >
+  due={{due_day_of_month}}; warn={{warn_days}}; name="{{bill_name}}";
+  today=$(date +%-d);
+  days_left=$(( due - today ));
+  if [ "$days_left" -lt 0 ]; then days_left=$(( days_left + 30 )); fi
+  if [ "$days_left" -le "$warn" ]; then echo "REMINDER: $name due in $days_left day(s) (on day $due of the month)";
+  else echo "OK: $name due in $days_left day(s)"; fi
+variables:
+  bill_name:
+    default: "Rent"
+    description: What the bill is, for the reminder text.
+  due_day_of_month:
+    default: 1
+    description: Day of the month (1-31) the bill is due.
+  warn_days:
+    default: 3
+    description: Start warning this many days before the due day.
+compatible_agents: [generic, claude, codex]
+notes: >
+  Zero-token, deterministic. Approximates month length as 30 days when
+  wrapping into next month — fine for a reminder, not for precise billing math.

package/jobs/personal/habit-checkin.yaml

@@ -0,0 +1,35 @@
+id: habit-checkin
+version: 1
+name: Daily Habit Check-in
+description: >
+  Reminds you to log a habit each day and reports your current streak.
+  Use this if you're trying to build a habit and want a daily nudge plus
+  a running streak count without a separate app.
+category: personal
+tags: [habit, streak, reminder]
+schedule: "0 20 * * *"
+timezone: "America/Los_Angeles"
+runner: shell
+command: >
+  log={{log_path}}; name="{{habit_name}}";
+  touch "$log";
+  today=$(date +%F);
+  streak=0; d="$today";
+  while grep -qx "$d" "$log" 2>/dev/null; do
+    streak=$((streak+1));
+    d=$(date -j -v-1d -f %F "$d" +%F 2>/dev/null || date -d "$d -1 day" +%F);
+  done;
+  if grep -qx "$today" "$log"; then echo "$name: already logged today. Streak: $streak day(s).";
+  else echo "REMINDER: log $name today to keep your streak (currently $streak day(s))."; fi
+variables:
+  habit_name:
+    default: "exercise"
+    description: What habit you're tracking, for the reminder text.
+  log_path:
+    default: "./habit-log.txt"
+    description: Plain text file with one YYYY-MM-DD line per day you completed the habit.
+compatible_agents: [generic, claude, codex]
+notes: >
+  Zero-token, deterministic. This job only reminds and reports the streak —
+  append today's date to log_path yourself (`date +%F >> log_path`) when
+  you actually complete the habit.

package/jobs/personal/meal-plan-reminder.yaml

@@ -0,0 +1,31 @@
+id: meal-plan-reminder
+version: 1
+name: Weekly Meal Plan Reminder
+description: >
+  Nudges you to plan the week's meals, and can draft a simple 7-day plan
+  plus grocery list for you. Use this if you dread the "what's for dinner"
+  question every night and want to decide once a week instead.
+category: personal
+tags: [meals, planning, household]
+schedule: "0 9 * * 0"
+timezone: "America/Los_Angeles"
+runner: hybrid
+command: >
+  echo "Reminder: plan meals for the week ({{household_size}} people, dietary preference: {{dietary_pref}})."
+prompt: |
+  Draft a simple 7-day dinner plan for {{household_size}} people with
+  dietary preference: {{dietary_pref}}.
+  1. One line per day, easy/quick recipes, minimal specialty ingredients.
+  2. End with a consolidated grocery list grouped by store section.
+script_note: >
+  `command` only prints a reminder to plan meals yourself, zero tokens.
+  `prompt` actually drafts the 7-day plan and grocery list for you.
+variables:
+  household_size:
+    default: 1
+    description: Number of people to plan meals for.
+  dietary_pref:
+    default: "no restrictions"
+    description: Dietary preference or restriction to plan around.
+compatible_agents: [claude, codex, hermes, openclaw, generic]
+notes: Schedule defaults to Sunday morning; adjust to whenever you actually grocery shop.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wonsukchoi/crondex",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "A public directory of pre-made, agent-editable cron jobs.",
   "type": "module",
   "license": "MIT",