Sovereign 8s.is mirror of 8b-is/cc-cron
  • Swift 86.8%
  • Shell 8.8%
  • Just 4.1%
  • Makefile 0.3%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-10-21 01:59:05 +09:00
.claude/skills chore: add CLAUDE.md, project skills, and update gitignore 2026-04-08 23:14:59 +02:00
.github/workflows test: add XCTest suite for CronParser, LaunchdScanner, RunRecord, and RunStore (closes #4) 2026-10-21 01:59:05 +09:00
CcCron test: add XCTest suite for CronParser, LaunchdScanner, RunRecord, and RunStore (closes #4) 2026-10-21 01:59:05 +09:00
CcCronTests test: add XCTest suite for CronParser, LaunchdScanner, RunRecord, and RunStore (closes #4) 2026-10-21 01:59:05 +09:00
.editorconfig chore: setup-skills target, editorconfig, and README AI dev setup section 2026-04-08 23:23:32 +02:00
.gitignore chore: add CLAUDE.md, project skills, and update gitignore 2026-04-08 23:14:59 +02:00
CHANGELOG.md chore: add justfile, CI workflow, changelog, and v0.1.0 tag 2026-04-08 22:54:57 +02:00
CLAUDE.md chore: add CLAUDE.md, project skills, and update gitignore 2026-04-08 23:14:59 +02:00
justfile test: add XCTest suite for CronParser, LaunchdScanner, RunRecord, and RunStore (closes #4) 2026-10-21 01:59:05 +09:00
Makefile chore: initialize repo with build config and .gitignore 2026-04-08 20:18:18 +02:00
project.yml test: add XCTest suite for CronParser, LaunchdScanner, RunRecord, and RunStore (closes #4) 2026-10-21 01:59:05 +09:00
README.md chore: setup-skills target, editorconfig, and README AI dev setup section 2026-04-08 23:23:32 +02:00

cc-cron

A native macOS menu bar app for discovering, monitoring, and running scheduled tasks — cron jobs and launchd agents — without touching the terminal.

macOS Swift License


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 list on 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