Sovereign 8s.is mirror of 8b-is/cc-cron
- Swift 86.8%
- Shell 8.8%
- Just 4.1%
- Makefile 0.3%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
|
|
||
| .claude/skills | ||
| .github/workflows | ||
| CcCron | ||
| CcCronTests | ||
| .editorconfig | ||
| .gitignore | ||
| CHANGELOG.md | ||
| CLAUDE.md | ||
| justfile | ||
| Makefile | ||
| project.yml | ||
| README.md | ||
cc-cron
A native macOS menu bar app for discovering, monitoring, and running scheduled tasks — cron jobs and launchd agents — without touching the terminal.
Features
- Unified discovery — cron (user crontab,
/etc/crontab,/etc/cron.d/*) and launchd (~/Library/LaunchAgents,/Library/LaunchAgents) in one view - Live state — loaded/running status pulled from
launchctl liston every refresh; detects automatic runs between poll cycles - Org-grouped sections — launchd agents grouped by reverse-domain prefix (
com.apple.*→apple) - Click to expand — action bar per task: Run, Logs, Open plist, Copy content
- Run history — captures exit code, duration, and stdout+stderr for every manual run; persists across launches
- Load / Unload — right-click any launchd agent to load or unload it without leaving the app
- File system watching — instant refresh when plists or cron.d entries change
- CRON_TZ / TZ support — next-run times respect timezone declarations in crontab files
- Failure notifications — system notification on non-zero exit, for both manual and automatic runs
- Settings — launch at login, show/hide system tasks (event-driven,
@reboot, WatchPaths) - Serene design — adaptive parchment/ink palette, academic aesthetic, no visual noise
Requirements
- macOS 14.0+
- Xcode 15+ (to build from source)
- XcodeGen (
brew install xcodegen) - just (
brew install just) — task runner
Build
git clone https://github.com/peterlodri-sec/cc-cron.git
cd cc-cron
just setup-skills # first-time: installs swiftui-skills + extracts Xcode docs
just open # generate project + open in Xcode
# or
just build # CLI build only
The .xcodeproj is generated from project.yml and not committed — always use just to regenerate it.
AI development setup
This project uses swiftui-skills — Apple-authored SwiftUI guidance extracted from your local Xcode installation — to keep AI-generated code idiomatic and accurate.
just setup-skills
Run once after cloning. Requires Xcode 15+ installed locally. The extracted docs land in .claude/skills/swiftui-skills/docs/ (gitignored).
Usage
| Interaction | Action |
|---|---|
| Left-click menu bar icon | Open task list |
| Click a task row | Expand — shows Run / Logs / Open / Copy actions |
| Right-click a task | Context menu: Load/Unload, Reveal in Finder, Copy |
| ⚙ icon (footer) | Settings: launch at login, show system tasks |
| ↺ icon (footer) | Manual refresh |
Project structure
project.yml — XcodeGen config (source of truth for the Xcode project)
Makefile
CcCron/
AppMain.swift
AppDelegate.swift
Models/
ScheduledTask.swift
RunRecord.swift
Discovery/
CronParser.swift — parses crontab sources, computes next-run
LaunchdScanner.swift — scans plist files, queries launchctl
TaskMonitor.swift — aggregates sources, file watchers, run execution
Persistence/
RunStore.swift — JSON persistence in ~/Library/Application Support/cc-cron
Views/
Theme.swift — adaptive color tokens (Serene design system)
TaskListView.swift — popover: header, grouped list, settings panel
TaskRowView.swift — expandable row with action bar
RunDetailView.swift — inline run history and output panel