克劳德·克伦
AI编码助手的任务被推迟。MCP服务器+守护进程，允许任何AI编码助手为未来安排任务。
这与/loop? 已添加克劳德代码2.1.71/loop用于会话中的重复任务。它非常适合短暂的监控，但当你关闭终端时就会死亡。claude cron作为操作系统守护进程运行——您的任务在重启后仍能存活，并在您睡眠时执行。 阅读完整的比较.
快速入门
bun install
bun test # 38 tests
bun run typecheck # tsc --noEmitClaude代码配置
添加 ~/.claude/settings.json:
{
"mcpServers": {
"claude-cron": {
"command": "bun",
"args": ["run", "/Users/fernando/code/claude-cron/src/index.ts"],
"env": {
"CLAUDE_CRON_DB": "/Users/fernando/.claude/claude-cron.sqlite",
"GMAIL_ADDRESS": "frr@keepcoding.io",
"GMAIL_APP_PASSWORD": "op://FRR DEV/...",
"NTFY_TOPIC": "claude-cron-frr-xxx",
"NTFY_URL": "https://ntfy.sh"
}
}
}
}建筑
AI Assistant (Claude Code / Codex / Copilot)
│ stdio (MCP protocol)
▼
MCP Server (src/index.ts) ← Task CRUD
│ SQLite (WAL mode)
▼
Runner / Daemon (src/runner.ts) ← Loop: executes due tasks
├─ reminder → notification + email + push
├─ shell → Bun.spawn(command)
├─ claude → claude -p --output-format text "prompt"
├─ codex → codex --quiet "prompt"
└─ copilot → gh copilot suggest "prompt"MCP工具
| 工具 | 说明 |
|---|---|
schedule_task | 为未来安排任务 |
list_tasks | 列出任务（按状态、即将进行、标签筛选） |
cancel_task | 按ID取消任务 |
run_now | 标记任务以立即执行 |
install_daemon | 将运行者注册为操作系统服务 |
调度任务
{
name: "Nightly tests",
type: "shell", // reminder | shell | claude | codex | copilot
when: "daily at 3:00", // see "When expressions" below
payload: {
command: "cd ~/code/bfclaude && make test", // shell
// message: "...", // reminder
// prompt: "...", // claude/codex/copilot
// model: "haiku",
// workingDir: "/path",
// maxBudgetUsd: 0.10,
},
notify: ["notification", "email", "push"],
notifyTo: "frr@keepcoding.io",
tags: ["ci"],
}when 表达方式
| 类型 | 示例 |
|---|---|
| 自然语言 | "tomorrow 9:00", "in 30 minutes", "next friday at 3pm" |
| Cron（5个字段） | "0 9 * * 1", "*/5 * * * *" |
| ISO 8601 | "2026-03-01T09:00:00Z", "2026-03-01" |
| 快捷方式 | "every monday at 8", "daily at 9:00", "every 5 minutes" |
解析：时间节点（自然）+croner（cron）+正则表达式（快捷方式）。快捷方式在chrono节点之前进行评估，因此“每周一8点”不会被解释为单个日期。
结构
src/
├── index.ts # MCP server entry point (5 tools)
├── runner.ts # Daemon: oneshot (launchd) or --loop (dev)
├── queue.ts # SQLite: schema, CRUD, getDueTasks
├── scheduler.ts # parseWhen(): chrono-node + croner + shortcuts
├── adapters/
│ ├── types.ts # AIAdapter interface
│ ├── claude.ts # claude -p --output-format text
│ ├── codex.ts # codex --quiet (stub)
│ └── copilot.ts # gh copilot suggest (stub)
├── notify/
│ ├── types.ts # NotificationAdapter interface
│ ├── desktop.ts # node-notifier (cross-platform)
│ ├── email.ts # Direct SMTP to Gmail (TLS 465)
│ └── push.ts # ntfy.sh (mobile + Apple Watch)
└── daemon/
├── types.ts # DaemonInstaller interface
├── detect.ts # process.platform → installer
├── launchd.ts # macOS: ~/Library/LaunchAgents/
├── systemd.ts # Linux: ~/.config/systemd/user/
└── schtasks.ts # Windows: Task Scheduler跑者
两种模式：
# Oneshot (for launchd StartInterval / systemd timer)
bun run src/runner.ts
# Continuous loop (for dev or KeepAlive)
bun run src/runner.ts --loop守护进程每60秒读取一次SQLite（可通过以下方式配置 CLAUDE_CRON_INTERVAL)，执行到期任务并发送通知。
Cron任务在完成后会自动重新安排时间（next_run重新计算）。一次性任务过渡到 completed 或 failed.
守护进程
# Install (from Claude Code via MCP tool install_daemon, or manually):
# macOS:
bun run src/daemon/launchd.ts # generates plist + launchctl load
# Verify
launchctl list | grep claude-cron
tail -f ~/Library/Logs/claude-cron.log
# Uninstall
launchctl unload ~/Library/LaunchAgents/com.claude-cron.runner.plist通知
| 渠道 | 要求 | 环境变量 |
|---|---|---|
| 桌面 | 节点通知器（包括在内） | -- |
| 电子邮件 | Gmail应用程序密码 | GMAIL_ADDRESS, GMAIL_APP_PASSWORD |
| 手机/手表上的推送（ntfy） | ntfy应用程序 | NTFY_TOPIC, NTFY_URL （可选）， NTFY_TOKEN （可选） |
SQLite架构
tasks (
id TEXT PRIMARY KEY, -- nanoid 12 chars
name, type, status, -- type: reminder|shell|claude|codex|copilot
run_at INTEGER, -- Unix ts (one-off)
cron TEXT, -- Cron expression (recurring)
payload TEXT, -- JSON per type
notify_via TEXT, -- JSON array: ["notification","email","push"]
notify_to TEXT, -- Destination email
next_run, last_run, -- Timestamps
run_count, last_result, -- Executions + JSON result
created_at, created_by, tags -- Metadata
)依赖项
@modelcontextprotocol/sdk--MCP协议chrono-node--自然语言→ Datecroner--Cron解析+下一次运行nanoid--短IDnode-notifier--跨平台桌面通知zod--MCP输入验证bun:sqlite--内置，零存款
待办事项
- \[\]在real settings.json中配置MCP并进行端到端测试
- \[\]使用安装守护进程
install_daemon并验证整个周期 - \[\]设置ntfy以推送到手机/手表
- \[\]npm发布（名称待定）
- \[\]在macOS+Linux上进行CI测试
- \[\]带实际使用GIF的README