cron-claude 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 tygi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,260 @@
+# cron-claude
+
+Schedule any Claude prompt to run automatically on a cron. Add a job, set a schedule, forget about it.
+
+[![CI](https://github.com/tarsbotty/cron-claude/actions/workflows/ci.yml/badge.svg)](https://github.com/tarsbotty/cron-claude/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+---
+
+## What it does
+
+`cron-claude` is a lightweight daemon that runs `claude` CLI commands on a schedule. Define a prompt, set a cron expression, and the daemon fires it automatically — logging output to `~/.cron-claude/logs/`. It runs as a macOS LaunchAgent so it survives reboots, and it reloads jobs live when you edit the config. No server to babysit, no web UI, just prompts on a schedule.
+
+You can manage jobs from the CLI, from Claude Desktop or Claude Code via the bundled MCP server, or from Claude chat via the OpenClaw plugin.
+
+---
+
+## Why not just use OpenClaw?
+
+OpenClaw's scheduled agentic tasks are genuinely powerful — prompts that run on a timer, check things, take actions, and report back. But OpenClaw is a full personal AI platform with broad system access: files, email, calendar, browser, messaging. That's the point of it, but it's also a wide attack surface.
+
+`cron-claude` is just that one feature. Each job is a single `claude` invocation with a prompt you wrote — the blast radius is scoped to what that one call can do, on your terms, with no credentials stored in a platform. If you want scheduled agentic tasks without the overhead of a full AI stack, this is the trade-off.
+
+---
+
+## Install
+
+```bash
+npm install -g cron-claude
+cron-claude install-service   # sets up macOS LaunchAgent (auto-starts on login)
+```
+
+**Requirements:** Node.js 22+, `claude` CLI installed and authenticated (`~/.local/bin/claude`).
+
+---
+
+## Quick Start
+
+```bash
+# Add a job that runs daily at 9 AM
+cron-claude add \
+  --id morning-brief \
+  --schedule "0 9 * * *" \
+  --prompt "Check my email inbox for anything urgent and summarize it."
+
+# Confirm it's scheduled
+cron-claude list
+# ID                   Schedule        Model      Enabled  Prompt
+# --------------------------------------------------------------------------------
+# morning-brief        0 9 * * *       sonnet     true     Check my email inbox for anything urgent...
+
+# Check overall status
+cron-claude status
+# Cron-Claude Status
+#   Total jobs: 1
+#   Enabled:    1
+#   Disabled:   0
+```
+
+---
+
+## CLI Reference
+
+### `add`
+
+```bash
+cron-claude add --id <id> --schedule "<cron>" --prompt "<prompt>" [--model <model>] [--disabled]
+```
+
+| Flag | Required | Default | Description |
+|------|----------|---------|-------------|
+| `--id` | ✅ | — | Unique job identifier |
+| `--schedule` | ✅ | — | Cron expression (5-field) |
+| `--prompt` | ✅ | — | Prompt sent to `claude` |
+| `--model` | | `sonnet` | Claude model (`sonnet`, `opus`, `haiku`) |
+| `--disabled` | | `false` | Create job in disabled state |
+
+**Examples:**
+
+```bash
+# Daily at 2 PM
+cron-claude add --id daily-summary --schedule "0 14 * * *" --prompt "Summarize my day and post to Discord"
+
+# Every Monday at 9 AM with Opus
+cron-claude add --id weekly-review --schedule "0 9 * * 1" --prompt "Review open GitHub issues and write a priority list" --model opus
+
+# Add but keep disabled until ready
+cron-claude add --id nightly-report --schedule "0 23 * * *" --prompt "Generate nightly stats" --disabled
+```
+
+### `list`
+
+```bash
+cron-claude list
+```
+
+Prints a table of all configured jobs: ID, schedule, model, enabled state, and prompt preview.
+
+### `remove`
+
+```bash
+cron-claude remove <id>
+```
+
+Removes the job from `jobs.json`. The daemon reloads automatically.
+
+### `enable` / `disable`
+
+```bash
+cron-claude enable <id>
+cron-claude disable <id>
+```
+
+Toggle a job on or off without removing it.
+
+### `status`
+
+```bash
+cron-claude status
+```
+
+Shows total, enabled, and disabled job counts.
+
+---
+
+## MCP Server (Claude Desktop / Claude Code)
+
+`cron-claude` ships an [MCP](https://modelcontextprotocol.io) server so you can manage jobs directly from Claude Desktop, Claude Code, or any MCP client — no terminal needed.
+
+### Claude Desktop
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "cron-claude": {
+      "command": "cron-claude-mcp"
+    }
+  }
+}
+```
+
+Restart Claude Desktop. You can then say *"add a cron job that runs every morning and checks the weather"* and it'll use the tools directly.
+
+### Claude Code
+
+```bash
+claude mcp add cron-claude -- cron-claude-mcp
+```
+
+Or add to `.mcp.json` manually:
+
+```json
+{
+  "mcpServers": {
+    "cron-claude": {
+      "command": "cron-claude-mcp"
+    }
+  }
+}
+```
+
+### Available MCP Tools
+
+| Tool | Description | Parameters |
+|------|-------------|------------|
+| `add_cron` | Add a new scheduled job | `id`, `schedule`, `prompt`, `model?`, `disabled?` |
+| `list_crons` | List all configured jobs | — |
+| `remove_cron` | Remove a job by ID | `id` |
+| `enable_cron` | Enable a disabled job | `id` |
+| `disable_cron` | Disable a job without removing it | `id` |
+| `get_status` | Daemon status + job counts | — |
+
+---
+
+## Claude Code Plugin
+
+Install `cron-claude` from the Claude Code plugin marketplace:
+
+```bash
+claude plugin marketplace add github:tarsbotty/cron-claude
+claude plugin install cron-claude
+```
+
+Claude Code will automatically connect to the `cron-claude` MCP server, exposing all management tools without leaving your editor.
+
+---
+
+## OpenClaw Skill
+
+For OpenClaw users, the skill in `src/plugin/` exposes natural-language cron management via `SKILL.md`. Copy `src/plugin/` into your OpenClaw skills directory or reference it in your OpenClaw config.
+
+---
+
+## Config
+
+Jobs are stored in `~/.cron-claude/jobs.json`. The daemon watches this file and reloads automatically on any change — no restart required.
+
+**Example `jobs.json`:**
+
+```json
+{
+  "jobs": [
+    {
+      "id": "morning-brief",
+      "schedule": "0 9 * * *",
+      "prompt": "Check my email inbox for anything urgent and summarize it.",
+      "model": "sonnet",
+      "enabled": true
+    },
+    {
+      "id": "weekly-review",
+      "schedule": "0 9 * * 1",
+      "prompt": "Review open GitHub issues and write a priority list.",
+      "model": "opus",
+      "enabled": true
+    }
+  ]
+}
+```
+
+### Cron Syntax
+
+Standard 5-field format: `minute hour day-of-month month day-of-week`
+
+| Expression | Meaning |
+|------------|---------|
+| `0 9 * * *` | Daily at 9:00 AM |
+| `0 14 * * *` | Daily at 2:00 PM |
+| `*/30 * * * *` | Every 30 minutes |
+| `0 9 * * 1` | Mondays at 9:00 AM |
+| `0 0 1 * *` | First of each month at midnight |
+
+---
+
+## How it works
+
+A macOS LaunchAgent keeps the `cron-claude` daemon alive across reboots. On startup, the daemon loads `~/.cron-claude/jobs.json`, validates each job with [Zod](https://zod.dev), and registers schedules using [node-cron](https://github.com/node-cron/node-cron). When a job fires, the daemon calls `execFile` on the `claude` CLI with `--print --model <model> <prompt>` and a 5-minute timeout. Output (or any error) is written to a timestamped log file in `~/.cron-claude/logs/`. The config file is watched via `fs.watch`; any edit triggers a debounced reload so you never need to restart the daemon manually.
+
+---
+
+## Development
+
+```bash
+git clone git@github.com:tarsbotty/cron-claude.git
+cd cron-claude
+npm install
+npm run build    # compile TypeScript → dist/
+npm test         # run vitest with coverage (90% threshold enforced)
+npm run dev      # run daemon directly with tsx (no build step)
+```
+
+**Test suite:** `tests/` covers the config layer, scheduler, daemon, CLI, and MCP server handlers. Coverage thresholds are enforced in `vitest.config.ts` (statements/functions/lines: 90%, branches: 85%).
+
+---
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+declare const program: Command;
+export { program };

package/dist/cli.js

@@ -0,0 +1,107 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { addJob, removeJob, listJobs, toggleJob, JobSchema } from './config.js';
+const program = new Command();
+program
+    .name('cron-claude')
+    .description('Manage scheduled Claude CLI jobs')
+    .version('1.0.0');
+program
+    .command('list')
+    .description('List all scheduled jobs')
+    .action(() => {
+    const jobs = listJobs();
+    if (jobs.length === 0) {
+        console.log('No jobs configured.');
+        return;
+    }
+    console.log(`\n${'ID'.padEnd(20)} ${'Schedule'.padEnd(15)} ${'Model'.padEnd(10)} ${'Enabled'.padEnd(8)} Prompt`);
+    console.log('-'.repeat(80));
+    for (const job of jobs) {
+        console.log(`${job.id.padEnd(20)} ${job.schedule.padEnd(15)} ${job.model.padEnd(10)} ${String(job.enabled).padEnd(8)} ${job.prompt.slice(0, 40)}`);
+    }
+    console.log('');
+});
+program
+    .command('add')
+    .description('Add a new scheduled job')
+    .requiredOption('--id <id>', 'Unique job identifier')
+    .requiredOption('--schedule <cron>', 'Cron schedule expression')
+    .requiredOption('--prompt <prompt>', 'Prompt to send to Claude')
+    .option('--model <model>', 'Claude model to use', 'sonnet')
+    .option('--disabled', 'Create job in disabled state')
+    .action((opts) => {
+    try {
+        const job = JobSchema.parse({
+            id: opts.id,
+            schedule: opts.schedule,
+            prompt: opts.prompt,
+            model: opts.model,
+            enabled: !opts.disabled,
+        });
+        addJob(job);
+        console.log(`Job "${job.id}" added successfully.`);
+    }
+    catch (err) {
+        console.error(`Error: ${err.message}`);
+        process.exit(1);
+    }
+});
+program
+    .command('remove <id>')
+    .description('Remove a scheduled job')
+    .action((id) => {
+    try {
+        removeJob(id);
+        console.log(`Job "${id}" removed.`);
+    }
+    catch (err) {
+        console.error(`Error: ${err.message}`);
+        process.exit(1);
+    }
+});
+program
+    .command('enable <id>')
+    .description('Enable a job')
+    .action((id) => {
+    try {
+        toggleJob(id, true);
+        console.log(`Job "${id}" enabled.`);
+    }
+    catch (err) {
+        console.error(`Error: ${err.message}`);
+        process.exit(1);
+    }
+});
+program
+    .command('disable <id>')
+    .description('Disable a job')
+    .action((id) => {
+    try {
+        toggleJob(id, false);
+        console.log(`Job "${id}" disabled.`);
+    }
+    catch (err) {
+        console.error(`Error: ${err.message}`);
+        process.exit(1);
+    }
+});
+program
+    .command('status')
+    .description('Show daemon status')
+    .action(() => {
+    const jobs = listJobs();
+    const enabled = jobs.filter((j) => j.enabled).length;
+    const disabled = jobs.filter((j) => !j.enabled).length;
+    console.log(`\nCron-Claude Status`);
+    console.log(`  Total jobs: ${jobs.length}`);
+    console.log(`  Enabled:    ${enabled}`);
+    console.log(`  Disabled:   ${disabled}\n`);
+});
+export { program };
+// Run if executed directly
+const isMain = process.argv[1]?.endsWith('cli.ts') || process.argv[1]?.endsWith('cli.js');
+if (isMain) {
+    program.parse();
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -0,0 +1,69 @@
+import { z } from 'zod';
+export declare const JobSchema: z.ZodObject<{
+    id: z.ZodString;
+    schedule: z.ZodString;
+    prompt: z.ZodString;
+    model: z.ZodDefault<z.ZodString>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    schedule: string;
+    prompt: string;
+    model: string;
+    enabled: boolean;
+}, {
+    id: string;
+    schedule: string;
+    prompt: string;
+    model?: string | undefined;
+    enabled?: boolean | undefined;
+}>;
+export declare const ConfigSchema: z.ZodObject<{
+    jobs: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        schedule: z.ZodString;
+        prompt: z.ZodString;
+        model: z.ZodDefault<z.ZodString>;
+        enabled: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        schedule: string;
+        prompt: string;
+        model: string;
+        enabled: boolean;
+    }, {
+        id: string;
+        schedule: string;
+        prompt: string;
+        model?: string | undefined;
+        enabled?: boolean | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    jobs: {
+        id: string;
+        schedule: string;
+        prompt: string;
+        model: string;
+        enabled: boolean;
+    }[];
+}, {
+    jobs: {
+        id: string;
+        schedule: string;
+        prompt: string;
+        model?: string | undefined;
+        enabled?: boolean | undefined;
+    }[];
+}>;
+export type Job = z.infer<typeof JobSchema>;
+export type Config = z.infer<typeof ConfigSchema>;
+export declare function getConfigDir(): string;
+export declare function getConfigPath(): string;
+export declare function getLogsDir(): string;
+export declare function ensureConfigDir(): void;
+export declare function loadConfig(configPath?: string): Config;
+export declare function saveConfig(config: Config, configPath?: string): void;
+export declare function addJob(job: Job, configPath?: string): Config;
+export declare function removeJob(jobId: string, configPath?: string): Config;
+export declare function listJobs(configPath?: string): Job[];
+export declare function toggleJob(jobId: string, enabled: boolean, configPath?: string): Config;

package/dist/config.js

@@ -0,0 +1,96 @@
+import { z } from 'zod';
+import fs from 'node:fs';
+import path from 'node:path';
+export const JobSchema = z.object({
+    id: z.string().min(1),
+    schedule: z.string().min(1),
+    prompt: z.string().min(1),
+    model: z.string().default('sonnet'),
+    enabled: z.boolean().default(true),
+});
+export const ConfigSchema = z.object({
+    jobs: z.array(JobSchema),
+});
+const CONFIG_DIR = path.join(process.env.HOME || '~', '.cron-claude');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'jobs.json');
+const LOGS_DIR = path.join(CONFIG_DIR, 'logs');
+export function getConfigDir() {
+    return CONFIG_DIR;
+}
+export function getConfigPath() {
+    return CONFIG_FILE;
+}
+export function getLogsDir() {
+    return LOGS_DIR;
+}
+const EXAMPLE_CONFIG = {
+    jobs: [
+        {
+            id: 'daily-summary',
+            schedule: '0 14 * * *',
+            prompt: 'Summarize my day and send to Discord',
+            model: 'sonnet',
+            enabled: true,
+        },
+    ],
+};
+export function ensureConfigDir() {
+    if (!fs.existsSync(CONFIG_DIR)) {
+        fs.mkdirSync(CONFIG_DIR, { recursive: true });
+    }
+    if (!fs.existsSync(LOGS_DIR)) {
+        fs.mkdirSync(LOGS_DIR, { recursive: true });
+    }
+}
+export function loadConfig(configPath) {
+    const filePath = configPath ?? CONFIG_FILE;
+    ensureConfigDir();
+    if (!fs.existsSync(filePath)) {
+        const config = EXAMPLE_CONFIG;
+        fs.writeFileSync(filePath, JSON.stringify(config, null, 2), 'utf-8');
+        return config;
+    }
+    const raw = fs.readFileSync(filePath, 'utf-8');
+    const parsed = JSON.parse(raw);
+    return ConfigSchema.parse(parsed);
+}
+export function saveConfig(config, configPath) {
+    const filePath = configPath ?? CONFIG_FILE;
+    ensureConfigDir();
+    ConfigSchema.parse(config);
+    fs.writeFileSync(filePath, JSON.stringify(config, null, 2), 'utf-8');
+}
+export function addJob(job, configPath) {
+    const config = loadConfig(configPath);
+    if (config.jobs.some((j) => j.id === job.id)) {
+        throw new Error(`Job with id "${job.id}" already exists`);
+    }
+    config.jobs.push(job);
+    saveConfig(config, configPath);
+    return config;
+}
+export function removeJob(jobId, configPath) {
+    const config = loadConfig(configPath);
+    const idx = config.jobs.findIndex((j) => j.id === jobId);
+    if (idx === -1) {
+        throw new Error(`Job with id "${jobId}" not found`);
+    }
+    config.jobs.splice(idx, 1);
+    saveConfig(config, configPath);
+    return config;
+}
+export function listJobs(configPath) {
+    const config = loadConfig(configPath);
+    return config.jobs;
+}
+export function toggleJob(jobId, enabled, configPath) {
+    const config = loadConfig(configPath);
+    const job = config.jobs.find((j) => j.id === jobId);
+    if (!job) {
+        throw new Error(`Job with id "${jobId}" not found`);
+    }
+    job.enabled = enabled;
+    saveConfig(config, configPath);
+    return config;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/daemon.d.ts

@@ -0,0 +1,13 @@
+import { Scheduler } from './scheduler.js';
+export declare class Daemon {
+    private scheduler;
+    private watcher;
+    private configPath;
+    constructor(configPath?: string);
+    start(): void;
+    stop(): void;
+    getScheduler(): Scheduler;
+    private loadAndSchedule;
+    private watchConfig;
+}
+export declare function main(): void;

package/dist/daemon.js

@@ -0,0 +1,95 @@
+import fs from 'node:fs';
+import { loadConfig, getConfigPath, ensureConfigDir } from './config.js';
+import { Scheduler } from './scheduler.js';
+export class Daemon {
+    scheduler;
+    watcher = null;
+    configPath;
+    constructor(configPath) {
+        this.configPath = configPath ?? getConfigPath();
+        this.scheduler = new Scheduler({
+            onJobStart: (job) => {
+                console.log(`[cron-claude] Running job: ${job.id}`);
+            },
+            onJobComplete: (job, output) => {
+                console.log(`[cron-claude] Job ${job.id} completed. Output: ${output.slice(0, 200)}`);
+            },
+            onJobError: (job, error) => {
+                console.error(`[cron-claude] Job ${job.id} failed: ${error.message}`);
+            },
+        });
+    }
+    start() {
+        ensureConfigDir();
+        console.log('[cron-claude] Daemon starting...');
+        this.loadAndSchedule();
+        this.watchConfig();
+        console.log('[cron-claude] Daemon running. Watching for config changes.');
+    }
+    stop() {
+        console.log('[cron-claude] Daemon stopping...');
+        this.scheduler.unscheduleAll();
+        if (this.watcher) {
+            this.watcher.close();
+            this.watcher = null;
+        }
+        console.log('[cron-claude] Daemon stopped.');
+    }
+    getScheduler() {
+        return this.scheduler;
+    }
+    loadAndSchedule() {
+        try {
+            const config = loadConfig(this.configPath);
+            this.scheduler.unscheduleAll();
+            for (const job of config.jobs) {
+                try {
+                    this.scheduler.schedule(job);
+                    console.log(`[cron-claude] Scheduled: ${job.id} (${job.schedule})`);
+                }
+                catch (err) {
+                    console.error(`[cron-claude] Failed to schedule ${job.id}: ${err.message}`);
+                }
+            }
+            console.log(`[cron-claude] ${this.scheduler.getScheduledIds().length} jobs scheduled.`);
+        }
+        catch (err) {
+            console.error(`[cron-claude] Failed to load config: ${err.message}`);
+        }
+    }
+    watchConfig() {
+        let debounce = null;
+        try {
+            this.watcher = fs.watch(this.configPath, () => {
+                if (debounce)
+                    clearTimeout(debounce);
+                debounce = setTimeout(() => {
+                    console.log('[cron-claude] Config changed, reloading...');
+                    this.loadAndSchedule();
+                }, 500);
+            });
+        }
+        catch {
+            console.warn('[cron-claude] Could not watch config file. Changes require restart.');
+        }
+    }
+}
+/* c8 ignore start */
+export function main() {
+    const daemon = new Daemon();
+    daemon.start();
+    process.on('SIGINT', () => {
+        daemon.stop();
+        process.exit(0);
+    });
+    process.on('SIGTERM', () => {
+        daemon.stop();
+        process.exit(0);
+    });
+}
+const isMain = process.argv[1]?.endsWith('daemon.ts') || process.argv[1]?.endsWith('daemon.js');
+if (isMain) {
+    main();
+}
+/* c8 ignore stop */
+//# sourceMappingURL=daemon.js.map

package/dist/daemon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon.js","sourceRoot":"","sources":["../src/daemon.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,eAAe,EAAY,MAAM,aAAa,CAAC;AACnF,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,MAAM,OAAO,MAAM;IACT,SAAS,CAAY;IACrB,OAAO,GAAwB,IAAI,CAAC;IACpC,UAAU,CAAS;IAE3B,YAAY,UAAmB;QAC7B,IAAI,CAAC,UAAU,GAAG,UAAU,IAAI,aAAa,EAAE,CAAC;QAChD,IAAI,CAAC,SAAS,GAAG,IAAI,SAAS,CAAC;YAC7B,UAAU,EAAE,CAAC,GAAQ,EAAE,EAAE;gBACvB,OAAO,CAAC,GAAG,CAAC,8BAA8B,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;YACtD,CAAC;YACD,aAAa,EAAE,CAAC,GAAQ,EAAE,MAAc,EAAE,EAAE;gBAC1C,OAAO,CAAC,GAAG,CAAC,qBAAqB,GAAG,CAAC,EAAE,uBAAuB,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;YACxF,CAAC;YACD,UAAU,EAAE,CAAC,GAAQ,EAAE,KAAY,EAAE,EAAE;gBACrC,OAAO,CAAC,KAAK,CAAC,qBAAqB,GAAG,CAAC,EAAE,YAAY,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACxE,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAED,KAAK;QACH,eAAe,EAAE,CAAC;QAClB,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;QAEhD,IAAI,CAAC,eAAe,EAAE,CAAC;QACvB,IAAI,CAAC,WAAW,EAAE,CAAC;QAEnB,OAAO,CAAC,GAAG,CAAC,4DAA4D,CAAC,CAAC;IAC5E,CAAC;IAED,IAAI;QACF,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;QAChD,IAAI,CAAC,SAAS,CAAC,aAAa,EAAE,CAAC;QAC/B,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YACrB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACtB,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;IAC/C,CAAC;IAED,YAAY;QACV,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAEO,eAAe;QACrB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC3C,IAAI,CAAC,SAAS,CAAC,aAAa,EAAE,CAAC;YAE/B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;gBAC9B,IAAI,CAAC;oBACH,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;oBAC7B,OAAO,CAAC,GAAG,CAAC,4BAA4B,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,QAAQ,GAAG,CAAC,CAAC;gBACtE,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,OAAO,CAAC,KAAK,CAAC,oCAAoC,GAAG,CAAC,EAAE,KAAM,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;gBACzF,CAAC;YACH,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,CAAC,SAAS,CAAC,eAAe,EAAE,CAAC,MAAM,kBAAkB,CAAC,CAAC;QAC1F,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,wCAAyC,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QAClF,CAAC;IACH,CAAC;IAEO,WAAW;QACjB,IAAI,QAAQ,GAAyC,IAAI,CAAC;QAE1D,IAAI,CAAC;YACH,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,EAAE;gBAC5C,IAAI,QAAQ;oBAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;gBACrC,QAAQ,GAAG,UAAU,CAAC,GAAG,EAAE;oBACzB,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;oBAC1D,IAAI,CAAC,eAAe,EAAE,CAAC;gBACzB,CAAC,EAAE,GAAG,CAAC,CAAC;YACV,CAAC,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,IAAI,CAAC,qEAAqE,CAAC,CAAC;QACtF,CAAC;IACH,CAAC;CACF;AAED,qBAAqB;AACrB,MAAM,UAAU,IAAI;IAClB,MAAM,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;IAC5B,MAAM,CAAC,KAAK,EAAE,CAAC;IAEf,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;QACxB,MAAM,CAAC,IAAI,EAAE,CAAC;QACd,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;QACzB,MAAM,CAAC,IAAI,EAAE,CAAC;QACd,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;AAChG,IAAI,MAAM,EAAE,CAAC;IACX,IAAI,EAAE,CAAC;AACT,CAAC;AACD,oBAAoB"}

package/dist/mcp-server.d.ts

@@ -0,0 +1,34 @@
+#!/usr/bin/env node
+/**
+ * MCP (Model Context Protocol) server for cron-claude.
+ * Exposes cron job management as structured tool calls for Claude Desktop,
+ * Claude Code, and any MCP-compatible client.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export type ToolResult = {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+};
+export declare function handleAddCron(args: {
+    id: string;
+    schedule: string;
+    prompt: string;
+    model?: string;
+    disabled?: boolean;
+}): Promise<ToolResult>;
+export declare function handleListCrons(): Promise<ToolResult>;
+export declare function handleRemoveCron(args: {
+    id: string;
+}): Promise<ToolResult>;
+export declare function handleEnableCron(args: {
+    id: string;
+}): Promise<ToolResult>;
+export declare function handleDisableCron(args: {
+    id: string;
+}): Promise<ToolResult>;
+export declare function handleGetStatus(): Promise<ToolResult>;
+export declare const server: McpServer;
+export declare function main(): Promise<void>;

package/dist/mcp-server.js

@@ -0,0 +1,181 @@
+#!/usr/bin/env node
+/**
+ * MCP (Model Context Protocol) server for cron-claude.
+ * Exposes cron job management as structured tool calls for Claude Desktop,
+ * Claude Code, and any MCP-compatible client.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+import { addJob, removeJob, listJobs, toggleJob, JobSchema } from './config.js';
+import { exec } from 'node:child_process';
+import { promisify } from 'node:util';
+const execAsync = promisify(exec);
+// ─── Named handler functions (exported for testability + V8 coverage) ─────────
+export async function handleAddCron(args) {
+    try {
+        const job = JobSchema.parse({
+            id: args.id,
+            schedule: args.schedule,
+            prompt: args.prompt,
+            model: args.model ?? 'sonnet',
+            enabled: !(args.disabled ?? false),
+        });
+        addJob(job);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Job "${job.id}" added successfully.\nSchedule: ${job.schedule}\nModel: ${job.model}\nEnabled: ${job.enabled}`,
+                },
+            ],
+        };
+    }
+    catch (err) {
+        return {
+            content: [{ type: 'text', text: `Error adding job: ${err.message}` }],
+            isError: true,
+        };
+    }
+}
+export async function handleListCrons() {
+    try {
+        const jobs = listJobs();
+        if (jobs.length === 0) {
+            return {
+                content: [{ type: 'text', text: 'No cron jobs configured.' }],
+            };
+        }
+        const lines = jobs.map((job) => `• ${job.id}\n  Schedule: ${job.schedule}\n  Model: ${job.model}\n  Enabled: ${job.enabled}\n  Prompt: ${job.prompt}`);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `${jobs.length} job(s) configured:\n\n${lines.join('\n\n')}`,
+                },
+            ],
+        };
+    }
+    catch (err) {
+        return {
+            content: [{ type: 'text', text: `Error listing jobs: ${err.message}` }],
+            isError: true,
+        };
+    }
+}
+export async function handleRemoveCron(args) {
+    try {
+        removeJob(args.id);
+        return {
+            content: [{ type: 'text', text: `Job "${args.id}" removed successfully.` }],
+        };
+    }
+    catch (err) {
+        return {
+            content: [{ type: 'text', text: `Error removing job: ${err.message}` }],
+            isError: true,
+        };
+    }
+}
+export async function handleEnableCron(args) {
+    try {
+        toggleJob(args.id, true);
+        return {
+            content: [{ type: 'text', text: `Job "${args.id}" enabled successfully.` }],
+        };
+    }
+    catch (err) {
+        return {
+            content: [{ type: 'text', text: `Error enabling job: ${err.message}` }],
+            isError: true,
+        };
+    }
+}
+export async function handleDisableCron(args) {
+    try {
+        toggleJob(args.id, false);
+        return {
+            content: [{ type: 'text', text: `Job "${args.id}" disabled successfully.` }],
+        };
+    }
+    catch (err) {
+        return {
+            content: [{ type: 'text', text: `Error disabling job: ${err.message}` }],
+            isError: true,
+        };
+    }
+}
+export async function handleGetStatus() {
+    try {
+        const jobs = listJobs();
+        const enabled = jobs.filter((j) => j.enabled).length;
+        const disabled = jobs.filter((j) => !j.enabled).length;
+        let daemonStatus = 'unknown';
+        try {
+            const { stdout } = await execAsync('pgrep -f "cron-claude"');
+            daemonStatus = stdout.trim() ? 'running' : 'stopped';
+        }
+        catch {
+            daemonStatus = 'stopped';
+        }
+        const lines = [
+            `Daemon status: ${daemonStatus}`,
+            `Total jobs:    ${jobs.length}`,
+            `Enabled:       ${enabled}`,
+            `Disabled:      ${disabled}`,
+        ];
+        return {
+            content: [{ type: 'text', text: lines.join('\n') }],
+        };
+    }
+    catch (err) {
+        return {
+            content: [{ type: 'text', text: `Error getting status: ${err.message}` }],
+            isError: true,
+        };
+    }
+}
+// ─── Server setup ─────────────────────────────────────────────────────────────
+export const server = new McpServer({
+    name: 'cron-claude',
+    version: '1.0.0',
+});
+server.tool('add_cron', 'Add a new scheduled cron job that runs a Claude prompt on a schedule', {
+    id: z.string().min(1).describe('Unique identifier for the job'),
+    schedule: z
+        .string()
+        .min(1)
+        .describe('Cron schedule expression (e.g. "0 14 * * *" for daily at 2pm)'),
+    prompt: z.string().min(1).describe('Prompt to send to Claude when the job runs'),
+    model: z.string().optional().describe('Claude model to use (default: sonnet)'),
+    disabled: z
+        .boolean()
+        .optional()
+        .describe('Create the job in a disabled state (default: false)'),
+}, handleAddCron);
+server.tool('list_crons', 'List all configured cron jobs', {}, async () => handleListCrons());
+server.tool('remove_cron', 'Remove a scheduled cron job by ID', {
+    id: z.string().min(1).describe('ID of the job to remove'),
+}, handleRemoveCron);
+server.tool('enable_cron', 'Enable a previously disabled cron job', {
+    id: z.string().min(1).describe('ID of the job to enable'),
+}, handleEnableCron);
+server.tool('disable_cron', 'Disable a cron job without removing it', {
+    id: z.string().min(1).describe('ID of the job to disable'),
+}, handleDisableCron);
+server.tool('get_status', 'Get the current status of the cron-claude daemon and job counts', {}, async () => handleGetStatus());
+// ─── Main entry point ─────────────────────────────────────────────────────────
+export async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+/* c8 ignore start */
+const isMain = process.argv[1]?.endsWith('mcp-server.ts') || process.argv[1]?.endsWith('mcp-server.js');
+if (isMain) {
+    main().catch((err) => {
+        console.error('MCP server error:', err);
+        process.exit(1);
+    });
+}
+/* c8 ignore stop */
+//# sourceMappingURL=mcp-server.js.map

package/dist/mcp-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.js","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":"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"}

package/dist/scheduler.d.ts

@@ -0,0 +1,19 @@
+import { Job } from './config.js';
+export interface SchedulerOptions {
+    claudePath?: string;
+    onJobStart?: (job: Job) => void;
+    onJobComplete?: (job: Job, output: string) => void;
+    onJobError?: (job: Job, error: Error) => void;
+}
+export declare class Scheduler {
+    private tasks;
+    private options;
+    constructor(options?: SchedulerOptions);
+    getClaudePath(): string;
+    schedule(job: Job): void;
+    unschedule(jobId: string): void;
+    unscheduleAll(): void;
+    getScheduledIds(): string[];
+    executeJob(job: Job): Promise<string>;
+    private logJobOutput;
+}

package/dist/scheduler.js

@@ -0,0 +1,87 @@
+import cron from 'node-cron';
+import { execFile } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+import { getLogsDir } from './config.js';
+const CLAUDE_PATH = path.join(process.env.HOME || '~', '.local', 'bin', 'claude');
+export class Scheduler {
+    tasks = new Map();
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    getClaudePath() {
+        return this.options.claudePath ?? CLAUDE_PATH;
+    }
+    schedule(job) {
+        if (!job.enabled)
+            return;
+        if (!cron.validate(job.schedule)) {
+            throw new Error(`Invalid cron schedule for job "${job.id}": ${job.schedule}`);
+        }
+        // Stop existing task if re-scheduling
+        this.unschedule(job.id);
+        const task = cron.schedule(job.schedule, () => {
+            this.executeJob(job);
+        });
+        this.tasks.set(job.id, task);
+    }
+    unschedule(jobId) {
+        const existing = this.tasks.get(jobId);
+        if (existing) {
+            existing.stop();
+            this.tasks.delete(jobId);
+        }
+    }
+    unscheduleAll() {
+        for (const [id] of this.tasks) {
+            this.unschedule(id);
+        }
+    }
+    getScheduledIds() {
+        return Array.from(this.tasks.keys());
+    }
+    executeJob(job) {
+        return new Promise((resolve, reject) => {
+            this.options.onJobStart?.(job);
+            const args = ['--print', '--model', job.model, job.prompt];
+            const claudePath = this.getClaudePath();
+            execFile(claudePath, args, { timeout: 300000 }, (error, stdout, stderr) => {
+                const output = stdout || stderr || '';
+                this.logJobOutput(job, output, error ?? undefined);
+                if (error) {
+                    this.options.onJobError?.(job, error);
+                    reject(error);
+                }
+                else {
+                    this.options.onJobComplete?.(job, output);
+                    resolve(output);
+                }
+            });
+        });
+    }
+    logJobOutput(job, output, error) {
+        const logsDir = getLogsDir();
+        try {
+            if (!fs.existsSync(logsDir)) {
+                fs.mkdirSync(logsDir, { recursive: true });
+            }
+            const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+            const logFile = path.join(logsDir, `${job.id}_${timestamp}.log`);
+            const content = [
+                `Job: ${job.id}`,
+                `Time: ${new Date().toISOString()}`,
+                `Schedule: ${job.schedule}`,
+                `Model: ${job.model}`,
+                error ? `Error: ${error.message}` : 'Status: success',
+                `---`,
+                output,
+            ].join('\n');
+            fs.writeFileSync(logFile, content, 'utf-8');
+        }
+        catch {
+            // Logging failure shouldn't crash the daemon
+        }
+    }
+}
+//# sourceMappingURL=scheduler.js.map

package/dist/scheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.js","sourceRoot":"","sources":["../src/scheduler.ts"],"names":[],"mappings":"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"}

package/install.sh

@@ -0,0 +1,55 @@
+#!/bin/bash
+set -e
+
+PLIST_NAME="com.cron-claude.daemon"
+PLIST_PATH="$HOME/Library/LaunchAgents/${PLIST_NAME}.plist"
+INSTALL_DIR="$(cd "$(dirname "$0")" && pwd)"
+LOG_DIR="$HOME/.cron-claude/logs"
+
+mkdir -p "$HOME/Library/LaunchAgents"
+mkdir -p "$LOG_DIR"
+
+cat > "$PLIST_PATH" << EOF
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>Label</key>
+    <string>${PLIST_NAME}</string>
+    <key>ProgramArguments</key>
+    <array>
+        <string>$(which node)</string>
+        <string>${INSTALL_DIR}/dist/daemon.js</string>
+    </array>
+    <key>RunAtLoad</key>
+    <true/>
+    <key>KeepAlive</key>
+    <true/>
+    <key>StandardOutPath</key>
+    <string>${LOG_DIR}/daemon-stdout.log</string>
+    <key>StandardErrorPath</key>
+    <string>${LOG_DIR}/daemon-stderr.log</string>
+    <key>WorkingDirectory</key>
+    <string>${INSTALL_DIR}</string>
+    <key>EnvironmentVariables</key>
+    <dict>
+        <key>PATH</key>
+        <string>/usr/local/bin:/usr/bin:/bin:$HOME/.local/bin</string>
+        <key>HOME</key>
+        <string>${HOME}</string>
+    </dict>
+</dict>
+</plist>
+EOF
+
+echo "LaunchAgent plist written to: $PLIST_PATH"
+
+# Unload if already loaded
+launchctl unload "$PLIST_PATH" 2>/dev/null || true
+
+# Load the agent
+launchctl load "$PLIST_PATH"
+
+echo "cron-claude daemon installed and started."
+echo "To stop:    launchctl unload $PLIST_PATH"
+echo "To restart: launchctl unload $PLIST_PATH && launchctl load $PLIST_PATH"

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "cron-claude",
+  "version": "1.0.0",
+  "description": "Schedule any Claude prompt to run automatically on a cron. Lightweight alternative to a full AI platform for recurring agentic tasks.",
+  "type": "module",
+  "main": "dist/daemon.js",
+  "bin": {
+    "cron-claude": "dist/cli.js",
+    "cron-claude-mcp": "dist/mcp-server.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/daemon.ts",
+    "start": "node dist/daemon.js",
+    "cli": "tsx src/cli.ts",
+    "test": "vitest run --coverage",
+    "test:watch": "vitest",
+    "install-service": "bash install.sh",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "dist/",
+    "install.sh",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "claude",
+    "cron",
+    "mcp",
+    "ai",
+    "automation",
+    "scheduler",
+    "anthropic",
+    "claude-code"
+  ],
+  "author": "tygi",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tygiacalone/cron-claude.git"
+  },
+  "homepage": "https://github.com/tygiacalone/cron-claude#readme",
+  "bugs": {
+    "url": "https://github.com/tygiacalone/cron-claude/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "commander": "^12.1.0",
+    "node-cron": "^3.0.3",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/node-cron": "^3.0.11",
+    "@vitest/coverage-v8": "^2.1.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0"
+  }
+}