scorpiox-cronshell

A crontab wrapper CLI that simplifies scheduling and managing recurring tasks on Unix-like systems.

Linux x64Linux ARM64macOS ARM64

๐Ÿ“– Description

scorpiox-cron is a lightweight wrapper around the system crontab that provides a friendlier interface for creating, listing, editing, and removing cron jobs. Instead of manually editing the crontab file and remembering cron expression syntax, scorpiox-cron lets you manage scheduled tasks through simple CLI commands. It reads and writes the user's crontab directly, supports common scheduling presets, and validates entries before installing them.

โš™๏ธ Flags & Options

This tool operates via subcommands and arguments rather than traditional flags.

๐Ÿ’ป Usage Examples

list jobs
# List all scheduled cron jobs for the current user
scorpiox-cron list
add job
# Run a backup script every day at 2:30 AM
scorpiox-cron add "30 2 * * *" "/home/user/backup.sh"

# Run a cleanup every Monday at midnight
scorpiox-cron add "0 0 * * 1" "/usr/local/bin/cleanup --older-than 30d"

# Collect system metrics every 5 minutes
scorpiox-cron add "*/5 * * * *" "/opt/monitor/collect-metrics.sh"
remove job
# Remove a cron job by its index (from list output)
scorpiox-cron remove 3

# Remove a job by matching the command pattern
scorpiox-cron remove "backup.sh"
edit & manage
# Open the crontab in an interactive editor
scorpiox-cron edit

# Clear all cron jobs for the current user
scorpiox-cron clear

# Show crontab raw output (pass-through to crontab -l)
scorpiox-cron raw
schedule presets
# Use preset schedules for common intervals
scorpiox-cron add @hourly "/opt/sync/pull-updates.sh"
scorpiox-cron add @daily "/opt/logs/rotate.sh"
scorpiox-cron add @weekly "/opt/maintenance/vacuum-db.sh"
scorpiox-cron add @reboot "/opt/services/start-all.sh"
real-world workflow
# Typical server setup: schedule log rotation, backups, and monitoring
scorpiox-cron add "0 3 * * *" "/opt/backup/snapshot.sh >> /var/log/backup.log 2>&1"
scorpiox-cron add "*/10 * * * *" "/opt/health/check-services.sh"
scorpiox-cron add "0 0 * * 0" "/opt/maintenance/prune-docker.sh"

# Verify all jobs are installed
scorpiox-cron list

๐Ÿ“ฆ Source & Build Info

Source File
scorpiox/scorpiox-cron.c
Lines of Code
1163
Dependencies
โ€”
Platforms
linux-x64 ยท linux-arm64 ยท macos-arm64

๐Ÿ”— Related Tools