joonlab

Claude Code macOS Scheduler — Productivity skill for Claude Code

Productivity community

Native macOS app to schedule and automate Claude Code CLI tasks using launchd.

How to install Claude Code macOS Scheduler

This entry records only its repository, not the path inside it, so there is no exact command to give. Open joonlab/claude-code-macos-scheduler and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Claude Code macOS Scheduler does

Native macOS app to schedule and automate Claude Code CLI tasks using launchd. Swift + SwiftUI, MVVM architecture.

Alternatives in Productivity

Reviews Plans — Review all active architecture plans relevant to the current task 15.6k ★
Tradingview MCP — Real-time crypto & stock screening, advanced technical indicators, Bollinger Bands intelligence, candlestick p 2.6k ★
🤝 Contributing To Agent Skills — First of all, thank you for taking the time to contribute 1.7k ★

README

Claude Code macOS Scheduler

**macOS 네이티브 앱으로 Claude Code CLI를 스케줄링하고 자동 실행하는 도구**

A native macOS app to schedule and automate Claude Code CLI tasks using launchd.

소개 / Overview

Claude Code Scheduler는 Claude Code CLI를 **정해진 시간에 자동으로 실행**하는 macOS 네이티브 앱입니다. 서버나 클라우드 없이 **내 Mac에서 직접** AI 자동화 파이프라인을 구축할 수 있습니다.

주요 기능

launchd 기반 스케줄링 — 앱이 꺼져 있어도 macOS가 알아서 실행
3가지 스케줄 모드 — 간격(매 N분), 매일 특정 시간, 매주 특정 요일
2가지 실행 모드 — 백그라운드(자동) / iTerm(실시간 확인)
폴더 분류 — Job을 폴더로 정리 (색상 커스터마이징)
메뉴 바 아이콘 — 빠른 접근 및 즉시 실행
실행 로그 — Job별 로그 자동 저장 및 아카이브

아키텍처 / Architecture

┌──────────────────────────────────────────────────────────────┐
│                    ClaudeSchedulerApp                         │
│              (@main, WindowGroup + MenuBarExtra)              │
└───────────────────────────┬──────────────────────────────────┘
                            │ .environment(viewModel)
┌───────────────────────────▼──────────────────────────────────┐
│                      JobViewModel                             │
│                     (@Observable)                             │
│  jobs, folders, selectedJobIDs, filteredJobs                  │
└──────┬────────────────────┬────────────────────┬─────────────┘
       │                    │                    │
┌──────▼──────┐   ┌────────▼────────┐   ┌──────▼──────────┐
│  Storage    │   │    Launchd      │   │   Executor      │
│  Service    │   │    Service      │   │   Service       │
│             │   │                 │   │                 │
│ jobs.json   │   │ ~/Library/      │   │ Process()       │
│ folders.json│   │ LaunchAgents/   │   │ (background)    │
│ Logs/       │   │ *.plist         │   │                 │
│             │   │                 │   │ NSAppleScript   │
│ ~/Library/  │   │ launchctl       │   │ (iTerm)         │
│ Application │   │ load/unload     │   │                 │
│ Support/    │   │