scorpiox-cronCore

Platforms

Linux x64 Linux ARM64 macOS ARM64

A powerful crontab wrapper that simplifies scheduling, managing, pausing, and removing cron jobs from the command line. Integrates with scorpiox tmux sessions and supports one-shot tasks.

Flags & Options

Flag Short Description Takes Value
--add Add a new cron entry interactively No
--bash Run a bash command on schedule No
--clear Clear all scorpiox-managed cron entries No
--help -h Show help information Yes
--list List all current cron entries No
--once Schedule a one-shot task (runs once, then auto-removes) No
--pause Pause a cron entry (skip execution) No
--remove Remove a specific cron entry No
--resume Resume a paused cron entry No
--tmux Run command inside a scorpiox tmux session No

Usage Examples

List all cron jobs

# Show all currently scheduled cron entries
scorpiox-cron --list

Add a cron job interactively

# Launch interactive prompt to add a new cron entry
scorpiox-cron --add

# You'll be prompted for:
#   Schedule (cron expression): */5 * * * *
#   Command: /usr/local/bin/scorpiox-agent --run health-check

Schedule a bash command

# Run a disk usage report every hour, save to file
scorpiox-cron --bash "df -h > /tmp/report.txt"

# Run a backup script daily at midnight
scorpiox-cron --bash "tar czf /backup/data-$(date +%F).tar.gz /srv/data"

One-shot task

# Schedule a one-time reminder that auto-removes after execution
scorpiox-cron --once "notify-send 'Deployment window open'"

# One-shot database vacuum at 3 AM
scorpiox-cron --once "psql -c 'VACUUM ANALYZE;'"

Run inside tmux session

# Schedule a command that runs in a persistent tmux session
scorpiox-cron --tmux "check agents"

# Useful for long-running tasks that need visible output
scorpiox-cron --tmux "scorpiox-agent --run monitoring"

Pause and resume entries

# Temporarily disable a cron entry without removing it
scorpiox-cron --pause

# Re-enable the paused entry
scorpiox-cron --resume

Remove and clear

# Remove a specific cron entry (interactive selection)
scorpiox-cron --remove

# Clear ALL scorpiox-managed cron entries (use with caution)
scorpiox-cron --clear

Source & Build Info

Source File
scorpiox/scorpiox-cron.c
Lines of Code
1,132
Dependencies
None (statically linked)

Related Tools