@wonsukchoi/crondex 0.1.1 → 0.2.0

package/README.md

@@ -58,7 +58,9 @@ crondex/
 ├── jobs/
 │   ├── devops/
 │   ├── productivity/
-│   └── personal/
+│   ├── personal/
+│   ├── content/
+│   └── finance/
 └── scripts/
     ├── build-catalog.js   regenerates catalog.json from jobs/**/*.yaml
     └── validate-jobs.js   validates every job against the schema
@@ -66,24 +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 |
-| `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.
+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/catalog.json

@@ -1,7 +1,7 @@
 {
   "generated_by": "scripts/build-catalog.js",
   "schema": "schema/job.schema.json",
-  "count": 13,
+  "count": 24,
   "jobs": [
     {
       "id": "backup-reminder",
@@ -51,6 +51,57 @@
       ],
       "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,
@@ -132,6 +183,78 @@
       ],
       "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,
@@ -232,6 +355,30 @@
       ],
       "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,
@@ -259,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,
@@ -284,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,
@@ -308,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/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.1",
+  "version": "0.2.0",
   "description": "A public directory of pre-made, agent-editable cron jobs.",
   "type": "module",
   "license": "MIT",