@wonsukchoi/crondex 0.1.0 → 0.2.0

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,10 @@ crondex/
 ├── schema/job.schema.json spec every job file follows
 ├── jobs/
 │   ├── devops/
-│   └── productivity/
+│   ├── productivity/
+│   ├── personal/
+│   ├── content/
+│   └── finance/
 └── scripts/
     ├── build-catalog.js   regenerates catalog.json from jobs/**/*.yaml
     └── validate-jobs.js   validates every job against the schema
@@ -51,21 +68,58 @@ crondex/
 
 ## Available jobs
 
-| id | category | schedule | modes |
-|---|---|---|---|
-| `dependency-audit` | devops | `0 8 * * 1` | script + agent-prompt |
-| `log-cleanup` | devops | `30 3 * * *` | script |
-| `repo-health-check` | devops | `0 9 * * 1-5` | script + agent-prompt |
-| `backup-reminder` | devops | `0 9 * * *` | script |
-| `ssl-cert-expiry-check` | devops | `0 6 * * *` | script |
-| `uptime-ping-check` | devops | `*/15 * * * *` | script |
-| `cost-alert` | devops | `0 7 * * *` | script + agent-prompt |
-| `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 |
-
-Full details (description, tags, variables) live in `catalog.json` and each
-job's YAML file.
+24 jobs across 5 categories. Full details (description, tags, variables)
+live in `catalog.json` and each job's YAML file — run `crondex list` or
+browse `jobs/<category>/` for the plain-language rundown of each.
+
+**devops**
+
+| id | schedule | modes |
+|---|---|---|
+| `dependency-audit` | `0 8 * * 1` | script + agent-prompt |
+| `log-cleanup` | `30 3 * * *` | script |
+| `repo-health-check` | `0 9 * * 1-5` | script + agent-prompt |
+| `backup-reminder` | `0 9 * * *` | script |
+| `ssl-cert-expiry-check` | `0 6 * * *` | script |
+| `uptime-ping-check` | `*/15 * * * *` | script |
+| `cost-alert` | `0 7 * * *` | script + agent-prompt |
+| `disk-space-check` | `0 */6 * * *` | script |
+| `docker-image-prune` | `0 4 * * *` | script |
+| `env-drift-check` | `0 8 * * *` | script |
+| `stale-dependency-pr-nudge` | `0 9 * * 1-5` | script |
+
+**productivity**
+
+| id | schedule | modes |
+|---|---|---|
+| `daily-standup-summary` | `0 8 * * 1-5` | script + agent-prompt |
+| `inbox-triage` | `0 7,13 * * 1-5` | agent-prompt only |
+| `weekly-report` | `0 16 * * 5` | script + agent-prompt |
+
+**personal**
+
+| id | schedule | modes |
+|---|---|---|
+| `bill-due-reminder` | `0 9 * * *` | script |
+| `habit-checkin` | `0 20 * * *` | script |
+| `meal-plan-reminder` | `0 9 * * 0` | script + agent-prompt |
+| `water-intake-reminder` | `0 9,12,15,18 * * *` | script |
+| `screen-time-check` | `0 20 * * *` | agent-prompt only |
+
+**content**
+
+| id | schedule | modes |
+|---|---|---|
+| `changelog-digest` | `0 10 * * 5` | script + agent-prompt |
+| `broken-link-check` | `0 7 * * 1` | script |
+| `social-mentions-watch` | `0 9 * * *` | agent-prompt only |
+
+**finance**
+
+| id | schedule | modes |
+|---|---|---|
+| `subscription-audit` | `0 9 1 * *` | script |
+| `net-worth-snapshot` | `0 9 1 * *` | script |
 
 ## How a job works
 

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": 24,
   "jobs": [
     {
       "id": "backup-reminder",
@@ -27,6 +27,81 @@
       ],
       "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": "broken-link-check",
+      "version": 1,
+      "name": "Broken Link Check",
+      "description": "Checks a list of URLs and reports any that are dead. Use this if your site or docs have outbound/internal links that quietly rot over time.",
+      "category": "content",
+      "tags": [
+        "links",
+        "content",
+        "maintenance"
+      ],
+      "schedule": "0 7 * * 1",
+      "timezone": "UTC",
+      "runner": "shell",
+      "modes": [
+        "script"
+      ],
+      "compatible_agents": [
+        "generic",
+        "claude",
+        "codex"
+      ],
+      "path": "jobs/content/broken-link-check.yaml"
+    },
+    {
+      "id": "changelog-digest",
+      "version": 1,
+      "name": "Changelog Digest",
+      "description": "Rolls up recent commits into a draft changelog entry your users could actually read. Use this if you ship regularly but always write the changelog as an afterthought (or skip it).",
+      "category": "content",
+      "tags": [
+        "changelog",
+        "release",
+        "docs"
+      ],
+      "schedule": "0 10 * * 5",
+      "timezone": "UTC",
+      "runner": "hybrid",
+      "modes": [
+        "script",
+        "agent-prompt"
+      ],
+      "compatible_agents": [
+        "claude",
+        "codex",
+        "hermes",
+        "openclaw",
+        "generic"
+      ],
+      "path": "jobs/content/changelog-digest.yaml"
+    },
     {
       "id": "cost-alert",
       "version": 1,
@@ -108,6 +183,102 @@
       ],
       "path": "jobs/devops/dependency-audit.yaml"
     },
+    {
+      "id": "disk-space-check",
+      "version": 1,
+      "name": "Disk Space Check",
+      "description": "Checks how full a disk/volume is and warns you before it fills up. Use this if you've ever had a server or laptop grind to a halt because disk usage crept up unnoticed.",
+      "category": "devops",
+      "tags": [
+        "disk",
+        "monitoring",
+        "maintenance"
+      ],
+      "schedule": "0 */6 * * *",
+      "timezone": "UTC",
+      "runner": "shell",
+      "modes": [
+        "script"
+      ],
+      "compatible_agents": [
+        "generic",
+        "claude",
+        "codex"
+      ],
+      "path": "jobs/devops/disk-space-check.yaml"
+    },
+    {
+      "id": "docker-image-prune",
+      "version": 1,
+      "name": "Docker Image & Container Prune",
+      "description": "Cleans up stopped containers and dangling Docker images so they don't quietly eat your disk. Use this if you run Docker locally or on a server and never remember to clean up after yourself.",
+      "category": "devops",
+      "tags": [
+        "docker",
+        "cleanup",
+        "disk-space"
+      ],
+      "schedule": "0 4 * * *",
+      "timezone": "UTC",
+      "runner": "shell",
+      "modes": [
+        "script"
+      ],
+      "compatible_agents": [
+        "generic",
+        "claude",
+        "codex"
+      ],
+      "path": "jobs/devops/docker-image-prune.yaml"
+    },
+    {
+      "id": "env-drift-check",
+      "version": 1,
+      "name": "Env File Drift Check",
+      "description": "Compares your .env against .env.example and flags keys that are missing or extra. Use this if you've ever deployed and hit a crash because a new required env var never got set.",
+      "category": "devops",
+      "tags": [
+        "config",
+        "env",
+        "drift"
+      ],
+      "schedule": "0 8 * * *",
+      "timezone": "UTC",
+      "runner": "shell",
+      "modes": [
+        "script"
+      ],
+      "compatible_agents": [
+        "generic",
+        "claude",
+        "codex"
+      ],
+      "path": "jobs/devops/env-drift-check.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 +328,57 @@
       ],
       "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": "net-worth-snapshot",
+      "version": 1,
+      "name": "Net Worth Snapshot Reminder",
+      "description": "Reminds you to log your net worth each month and shows the trend from your last two entries. Use this if you want to track your finances over time but keep forgetting to actually sit down and do it.",
+      "category": "finance",
+      "tags": [
+        "finance",
+        "net-worth",
+        "tracking"
+      ],
+      "schedule": "0 9 1 * *",
+      "timezone": "UTC",
+      "runner": "shell",
+      "modes": [
+        "script"
+      ],
+      "compatible_agents": [
+        "generic",
+        "claude",
+        "codex"
+      ],
+      "path": "jobs/finance/net-worth-snapshot.yaml"
+    },
     {
       "id": "repo-health-check",
       "version": 1,
@@ -184,6 +406,58 @@
       ],
       "path": "jobs/devops/repo-health-check.yaml"
     },
+    {
+      "id": "screen-time-check",
+      "version": 1,
+      "name": "Screen Time Check",
+      "description": "Checks today's screen time against a goal and tells you if you're over. Use this if you're trying to cut down on screen time but never actually look at the stats your phone/laptop already collects.",
+      "category": "personal",
+      "tags": [
+        "health",
+        "screen-time",
+        "wellbeing"
+      ],
+      "schedule": "0 20 * * *",
+      "timezone": "America/Los_Angeles",
+      "runner": "agent-prompt",
+      "modes": [
+        "agent-prompt"
+      ],
+      "compatible_agents": [
+        "claude",
+        "codex",
+        "hermes",
+        "openclaw",
+        "generic"
+      ],
+      "path": "jobs/personal/screen-time-check.yaml"
+    },
+    {
+      "id": "social-mentions-watch",
+      "version": 1,
+      "name": "Social Mentions Watch",
+      "description": "Scans for recent mentions of your brand, product, or repo and summarizes them. Use this if you want to catch a complaint or bug report on social media before it turns into a bigger problem.",
+      "category": "content",
+      "tags": [
+        "social",
+        "mentions",
+        "monitoring"
+      ],
+      "schedule": "0 9 * * *",
+      "timezone": "UTC",
+      "runner": "agent-prompt",
+      "modes": [
+        "agent-prompt"
+      ],
+      "compatible_agents": [
+        "claude",
+        "codex",
+        "hermes",
+        "openclaw",
+        "generic"
+      ],
+      "path": "jobs/content/social-mentions-watch.yaml"
+    },
     {
       "id": "ssl-cert-expiry-check",
       "version": 1,
@@ -209,6 +483,54 @@
       ],
       "path": "jobs/devops/ssl-cert-expiry-check.yaml"
     },
+    {
+      "id": "stale-dependency-pr-nudge",
+      "version": 1,
+      "name": "Stale Dependency PR Nudge",
+      "description": "Lists open dependency-bump pull requests (from Dependabot/Renovate) that have been sitting for a while. Use this if automated PRs pile up and quietly go stale instead of getting merged or closed.",
+      "category": "devops",
+      "tags": [
+        "github",
+        "dependencies",
+        "pr"
+      ],
+      "schedule": "0 9 * * 1-5",
+      "timezone": "UTC",
+      "runner": "shell",
+      "modes": [
+        "script"
+      ],
+      "compatible_agents": [
+        "generic",
+        "claude",
+        "codex"
+      ],
+      "path": "jobs/devops/stale-dependency-pr-nudge.yaml"
+    },
+    {
+      "id": "subscription-audit",
+      "version": 1,
+      "name": "Subscription Audit",
+      "description": "Flags recurring subscriptions you haven't actually used in a while. Use this if you suspect you're paying for things you forgot to cancel.",
+      "category": "finance",
+      "tags": [
+        "subscriptions",
+        "budget",
+        "finance"
+      ],
+      "schedule": "0 9 1 * *",
+      "timezone": "UTC",
+      "runner": "shell",
+      "modes": [
+        "script"
+      ],
+      "compatible_agents": [
+        "generic",
+        "claude",
+        "codex"
+      ],
+      "path": "jobs/finance/subscription-audit.yaml"
+    },
     {
       "id": "uptime-ping-check",
       "version": 1,
@@ -233,6 +555,30 @@
       ],
       "path": "jobs/devops/uptime-ping-check.yaml"
     },
+    {
+      "id": "water-intake-reminder",
+      "version": 1,
+      "name": "Water Intake Reminder",
+      "description": "Nudges you to drink water a few times a day toward a daily goal. Use this if you sit at a desk all day and forget to drink water until you've got a headache.",
+      "category": "personal",
+      "tags": [
+        "health",
+        "hydration",
+        "reminder"
+      ],
+      "schedule": "0 9,12,15,18 * * *",
+      "timezone": "America/Los_Angeles",
+      "runner": "shell",
+      "modes": [
+        "script"
+      ],
+      "compatible_agents": [
+        "generic",
+        "claude",
+        "codex"
+      ],
+      "path": "jobs/personal/water-intake-reminder.yaml"
+    },
     {
       "id": "weekly-report",
       "version": 1,

package/jobs/content/broken-link-check.yaml

@@ -0,0 +1,33 @@
+id: broken-link-check
+version: 1
+name: Broken Link Check
+description: >
+  Checks a list of URLs and reports any that are dead. Use this if your
+  site or docs have outbound/internal links that quietly rot over time.
+category: content
+tags: [links, content, maintenance]
+schedule: "0 7 * * 1"
+timezone: "UTC"
+runner: shell
+command: >
+  file={{urls_file}};
+  [ -f "$file" ] || { echo "ERROR: $file not found"; exit 1; };
+  fail=0;
+  while IFS= read -r url; do
+    [ -z "$url" ] && continue;
+    code=$(curl -o /dev/null -s -w '%{http_code}' --max-time {{timeout_seconds}} "$url");
+    if [ "$code" -ge 400 ] || [ "$code" = "000" ]; then echo "BROKEN ($code): $url"; fail=1; fi
+  done < "$file";
+  [ "$fail" -eq 0 ] && echo "OK: all links responded successfully";
+  exit $fail
+variables:
+  urls_file:
+    default: "./links.txt"
+    description: Plain text file with one URL per line to check.
+  timeout_seconds:
+    default: 10
+    description: Max seconds to wait per URL before treating it as broken.
+compatible_agents: [generic, claude, codex]
+notes: >
+  Zero-token, deterministic. You maintain urls_file yourself (or generate
+  it from a sitemap) — this job only checks what's listed.

package/jobs/content/changelog-digest.yaml

@@ -0,0 +1,40 @@
+id: changelog-digest
+version: 1
+name: Changelog Digest
+description: >
+  Rolls up recent commits into a draft changelog entry your users could
+  actually read. Use this if you ship regularly but always write the
+  changelog as an afterthought (or skip it).
+category: content
+tags: [changelog, release, docs]
+schedule: "0 10 * * 5"
+timezone: "UTC"
+runner: hybrid
+command: >
+  cd {{repo_path}} && last_tag=$(git describe --tags --abbrev=0 2>/dev/null);
+  if [ -n "$last_tag" ]; then echo "--- commits since $last_tag ---"; git log "$last_tag"..HEAD --pretty=format:'%h %s';
+  else echo "--- no tags found, showing last {{lookback_days}} days ---"; git log --since="{{lookback_days}} days ago" --pretty=format:'%h %s'; fi
+prompt: |
+  Draft a user-facing changelog entry for {{project_name}} covering commits
+  since the last release (or the last {{lookback_days}} days if no tags
+  exist) in {{repo_path}}.
+  1. Group into Added / Changed / Fixed.
+  2. Rewrite terse commit messages into plain language a user would
+     actually understand.
+  3. Skip purely internal commits (refactors, tests, CI) unless they're
+     user-visible.
+script_note: >
+  `command` dumps the raw commit log since the last tag, zero tokens.
+  `prompt` groups and rewrites it into an actual user-facing changelog entry.
+variables:
+  repo_path:
+    default: "."
+    description: Path to the repo to pull history from.
+  project_name:
+    default: "this project"
+    description: Name to use in the changelog header.
+  lookback_days:
+    default: 14
+    description: Fallback window if the repo has no tags yet.
+compatible_agents: [claude, codex, hermes, openclaw, generic]
+notes: Schedule defaults to Friday; adjust to your release cadence.

package/jobs/content/social-mentions-watch.yaml

@@ -0,0 +1,32 @@
+id: social-mentions-watch
+version: 1
+name: Social Mentions Watch
+description: >
+  Scans for recent mentions of your brand, product, or repo and summarizes
+  them. Use this if you want to catch a complaint or bug report on social
+  media before it turns into a bigger problem.
+category: content
+tags: [social, mentions, monitoring]
+schedule: "0 9 * * *"
+timezone: "UTC"
+runner: agent-prompt
+prompt: |
+  Search for mentions of "{{brand_or_repo}}" from the last {{lookback_hours}}
+  hours across whatever sources you have access to (X/Twitter, Reddit,
+  Hacker News, web search).
+  1. List each mention with source, link, and a one-line sentiment read
+     (positive/neutral/negative).
+  2. Flag anything that looks like a bug report, complaint, or something
+     needing a response.
+  3. If nothing found, just say so.
+variables:
+  brand_or_repo:
+    default: "your project"
+    description: Name, handle, or repo to search mentions of.
+  lookback_hours:
+    default: 24
+    description: Window of mentions to consider.
+compatible_agents: [claude, codex, hermes, openclaw, generic]
+notes: >
+  No generic script mode — needs whatever search/API access your agent has
+  (web search, X API, Reddit API, etc.); sources vary too much to script generically.

package/jobs/devops/disk-space-check.yaml

@@ -0,0 +1,26 @@
+id: disk-space-check
+version: 1
+name: Disk Space Check
+description: >
+  Checks how full a disk/volume is and warns you before it fills up.
+  Use this if you've ever had a server or laptop grind to a halt because
+  disk usage crept up unnoticed.
+category: devops
+tags: [disk, monitoring, maintenance]
+schedule: "0 */6 * * *"
+timezone: "UTC"
+runner: shell
+command: >
+  path={{path}}; threshold={{threshold_pct}};
+  pct=$(df -P "$path" | awk 'NR==2 {gsub("%","",$5); print $5}');
+  if [ "$pct" -ge "$threshold" ]; then echo "WARNING: $path is ${pct}% full (threshold ${threshold}%)"; exit 1;
+  else echo "OK: $path is ${pct}% full"; fi
+variables:
+  path:
+    default: "/"
+    description: Mount point or path to check.
+  threshold_pct:
+    default: 85
+    description: Warn when usage reaches this percentage.
+compatible_agents: [generic, claude, codex]
+notes: Zero-token, deterministic. Uses `df -P` for portable output across macOS/Linux.

package/jobs/devops/docker-image-prune.yaml

@@ -0,0 +1,24 @@
+id: docker-image-prune
+version: 1
+name: Docker Image & Container Prune
+description: >
+  Cleans up stopped containers and dangling Docker images so they don't
+  quietly eat your disk. Use this if you run Docker locally or on a server
+  and never remember to clean up after yourself.
+category: devops
+tags: [docker, cleanup, disk-space]
+schedule: "0 4 * * *"
+timezone: "UTC"
+runner: shell
+command: >
+  command -v docker >/dev/null 2>&1 || { echo "docker not installed, skipping"; exit 0; };
+  docker container prune -f --filter "until={{until}}";
+  docker image prune -f --filter "until={{until}}"
+variables:
+  until:
+    default: "24h"
+    description: Only remove containers/images older than this (Docker duration syntax, e.g. "24h", "720h").
+compatible_agents: [generic, claude, codex]
+notes: >
+  Destructive by nature (removes stopped containers and dangling images) —
+  the `until` default of 24h protects anything recent. Widen with care.

package/jobs/devops/env-drift-check.yaml

@@ -0,0 +1,34 @@
+id: env-drift-check
+version: 1
+name: Env File Drift Check
+description: >
+  Compares your .env against .env.example and flags keys that are missing
+  or extra. Use this if you've ever deployed and hit a crash because a new
+  required env var never got set.
+category: devops
+tags: [config, env, drift]
+schedule: "0 8 * * *"
+timezone: "UTC"
+runner: shell
+command: >
+  example={{example_path}}; actual={{env_path}};
+  [ -f "$example" ] || { echo "ERROR: $example not found"; exit 1; };
+  [ -f "$actual" ] || { echo "ERROR: $actual not found"; exit 1; };
+  ex_keys=$(grep -vE '^\s*#|^\s*$' "$example" | cut -d= -f1 | sort -u);
+  ac_keys=$(grep -vE '^\s*#|^\s*$' "$actual" | cut -d= -f1 | sort -u);
+  missing=$(comm -23 <(echo "$ex_keys") <(echo "$ac_keys"));
+  extra=$(comm -13 <(echo "$ex_keys") <(echo "$ac_keys"));
+  [ -n "$missing" ] && echo "MISSING (in $example, not in $actual): $missing";
+  [ -n "$extra" ] && echo "EXTRA (in $actual, not in $example): $extra";
+  [ -z "$missing" ] && [ -z "$extra" ] && echo "OK: env keys match example"; true
+variables:
+  example_path:
+    default: ".env.example"
+    description: Path to the example/template env file.
+  env_path:
+    default: ".env"
+    description: Path to the actual env file to check.
+compatible_agents: [generic, claude, codex]
+notes: >
+  Zero-token, deterministic. Requires bash (uses process substitution) —
+  won't run under plain POSIX sh.

package/jobs/devops/stale-dependency-pr-nudge.yaml

@@ -0,0 +1,25 @@
+id: stale-dependency-pr-nudge
+version: 1
+name: Stale Dependency PR Nudge
+description: >
+  Lists open dependency-bump pull requests (from Dependabot/Renovate) that
+  have been sitting for a while. Use this if automated PRs pile up and
+  quietly go stale instead of getting merged or closed.
+category: devops
+tags: [github, dependencies, pr]
+schedule: "0 9 * * 1-5"
+timezone: "UTC"
+runner: shell
+command: >
+  command -v gh >/dev/null 2>&1 || { echo "gh CLI not installed, skipping"; exit 0; };
+  cd {{repo_path}} && gh pr list --state open --json number,title,author,createdAt --jq \
+    '.[] | select(.author.login | test("dependabot|renovate"; "i")) | select((now - (.createdAt | fromdateiso8601)) > ({{stale_days}} * 86400)) | "#\(.number) \(.title) (opened \(.createdAt))"'
+variables:
+  repo_path:
+    default: "."
+    description: Path to the repo to check.
+  stale_days:
+    default: 3
+    description: Flag dependency PRs open longer than this many days.
+compatible_agents: [generic, claude, codex]
+notes: Requires an authenticated `gh` CLI. Zero-token, read-only.

package/jobs/finance/net-worth-snapshot.yaml

@@ -0,0 +1,33 @@
+id: net-worth-snapshot
+version: 1
+name: Net Worth Snapshot Reminder
+description: >
+  Reminds you to log your net worth each month and shows the trend from
+  your last two entries. Use this if you want to track your finances over
+  time but keep forgetting to actually sit down and do it.
+category: finance
+tags: [finance, net-worth, tracking]
+schedule: "0 9 1 * *"
+timezone: "UTC"
+runner: shell
+command: >
+  file={{net_worth_csv}};
+  [ -f "$file" ] || echo "date,net_worth" > "$file";
+  today=$(date +%F);
+  if tail -n +2 "$file" | cut -d, -f1 | grep -qx "$today"; then
+    echo "Already logged today.";
+  else
+    echo "$today," >> "$file";
+    echo "REMINDER: fill in today's net worth in $file";
+  fi;
+  prev=$(tail -n 2 "$file" | head -n 1 | cut -d, -f2);
+  last=$(tail -n 1 "$file" | cut -d, -f2);
+  [ -n "$prev" ] && [ -n "$last" ] && echo "Last entry: $last (previous: $prev)"; true
+variables:
+  net_worth_csv:
+    default: "./net-worth.csv"
+    description: CSV log file, one row per month (date,net_worth).
+compatible_agents: [generic, claude, codex]
+notes: >
+  Zero-token. Appends a blank row for you to fill in by hand — doesn't
+  pull balances from any bank automatically.

package/jobs/finance/subscription-audit.yaml

@@ -0,0 +1,34 @@
+id: subscription-audit
+version: 1
+name: Subscription Audit
+description: >
+  Flags recurring subscriptions you haven't actually used in a while.
+  Use this if you suspect you're paying for things you forgot to cancel.
+category: finance
+tags: [subscriptions, budget, finance]
+schedule: "0 9 1 * *"
+timezone: "UTC"
+runner: shell
+command: >
+  file={{subs_file}}; unused_days={{unused_days}};
+  [ -f "$file" ] || { echo "ERROR: $file not found"; exit 1; };
+  today=$(date +%s);
+  tail -n +2 "$file" | while IFS=, read -r name cost last_used; do
+    last_epoch=$(date -j -f %Y-%m-%d "$last_used" +%s 2>/dev/null || date -d "$last_used" +%s);
+    days=$(( (today-last_epoch)/86400 ));
+    if [ "$days" -gt "$unused_days" ]; then echo "UNUSED: $name (\$$cost/mo) — not used in $days days"; fi
+  done
+variables:
+  subs_file:
+    default: "./subscriptions.csv"
+    description: >
+      CSV with header "name,monthly_cost,last_used_date" (YYYY-MM-DD), one
+      subscription per row.
+  unused_days:
+    default: 30
+    description: Flag a subscription if it hasn't been used in this many days.
+compatible_agents: [generic, claude, codex]
+notes: >
+  Zero-token, deterministic. You maintain subs_file yourself (update
+  last_used_date when you actually use each service) — this job only
+  reads what's in the file, doesn't pull from any bank or card statement.

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/jobs/personal/screen-time-check.yaml

@@ -0,0 +1,27 @@
+id: screen-time-check
+version: 1
+name: Screen Time Check
+description: >
+  Checks today's screen time against a goal and tells you if you're over.
+  Use this if you're trying to cut down on screen time but never actually
+  look at the stats your phone/laptop already collects.
+category: personal
+tags: [health, screen-time, wellbeing]
+schedule: "0 20 * * *"
+timezone: "America/Los_Angeles"
+runner: agent-prompt
+prompt: |
+  Check today's screen time against a {{daily_limit_hours}} hour goal.
+  1. Use whatever screen-time source you have access to (macOS Screen
+     Time, iOS Screen Time via Shortcuts, Android Digital Wellbeing,
+     RescueTime, etc.).
+  2. Report total screen time so far today vs. the goal.
+  3. If over goal, note the top 3 apps/categories driving it.
+variables:
+  daily_limit_hours:
+    default: 3
+    description: Daily screen time goal, in hours.
+compatible_agents: [claude, codex, hermes, openclaw, generic]
+notes: >
+  No generic script mode — screen-time data access is platform/tool
+  specific and usually needs OS-level permissions your agent may not have.

package/jobs/personal/water-intake-reminder.yaml

@@ -0,0 +1,20 @@
+id: water-intake-reminder
+version: 1
+name: Water Intake Reminder
+description: >
+  Nudges you to drink water a few times a day toward a daily goal. Use
+  this if you sit at a desk all day and forget to drink water until
+  you've got a headache.
+category: personal
+tags: [health, hydration, reminder]
+schedule: "0 9,12,15,18 * * *"
+timezone: "America/Los_Angeles"
+runner: shell
+command: >
+  echo "Reminder: drink some water. Goal: {{daily_goal_oz}} oz today."
+variables:
+  daily_goal_oz:
+    default: 64
+    description: Your daily water intake goal, in ounces.
+compatible_agents: [generic, claude, codex]
+notes: Zero-token. Purely a nudge — doesn't track actual intake.

package/package.json

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