Cron CLI (Alpha)

A universal CLI tool for creating and managing cron task management platforms.

⚠️ Alpha Version Notice: This is an alpha release. Features may change and stability is not guaranteed for production use.

Quick Start

Create a new project

# Using the alpha version
npx @alex-programmer/cron@alpha create my-cron-project
cd my-cron-project
npm install
npm run dev

Upgrade existing project

cd your-cron-project
npx @alex-programmer/cron@alpha upgrade

Installation Options

Use specific alpha version

npx @alex-programmer/[email protected] create my-project

Use latest alpha

npx @alex-programmer/cron@alpha create my-project

Features

The generated project includes:

• ✅ Modern Web Interface: Built with Next.js and Ant Design
• ⏰ Flexible Scheduling: Support for various cron expressions (every second/minute/hour/day/month)
• 🔄 Task Management: Pause, resume, and test tasks with real-time feedback
• 📊 Execution Monitoring: Comprehensive logs and statistics
• 🎯 Task Categories: Business tasks and Keep Alive monitoring
• 🔧 HTTP Configuration: Custom headers and request body support
• 💾 Data Persistence: SQLite database with environment-specific storage
• 📱 Responsive Design: Works on mobile and desktop
• 🚀 Easy Deployment: Ready for production deployment

Commands

cron create [project-name]

Creates a new cron task management project.

Options:

• -t, --template <template>: Template to use (default: "default")

Example:

npx @alex-programmer/cron@alpha create my-scheduler
npx @alex-programmer/cron@alpha create my-scheduler --template default

cron upgrade

Upgrades an existing project to the latest version while preserving your data and configurations.

Options:

• -f, --force: Force upgrade without confirmation

Example:

npx @alex-programmer/cron@alpha upgrade
npx @alex-programmer/cron@alpha upgrade --force

What gets preserved during upgrades?

• ✅ SQLite database files (cron_tasks.db, data/cron_tasks.db)
• ✅ Environment files (.env, .env.local, .env.production)
• ✅ Project name and custom package.json configurations
• ✅ Any custom data you've added

What gets updated during upgrades?

• 🔄 Core application files (app/, components/, lib/, types/)
• 🔄 Configuration files (next.config.ts, tsconfig.json, etc.)
• 🔄 Dependencies in package.json
• 🔄 Build scripts and tooling

Project Structure

After creating a project, you'll get:

my-cron-project/
├── app/                 # Next.js app directory
│   ├── api/            # API routes for task management
│   ├── globals.css     # Global styles
│   ├── layout.tsx      # Root layout
│   └── page.tsx        # Main dashboard
├── components/          # React components
│   ├── TaskForm.tsx    # Task creation/editing form
│   └── TaskLogs.tsx    # Execution logs display
├── lib/                # Core libraries
│   ├── cronManager.ts  # Task scheduling engine
│   ├── cronUtils.ts    # Cron expression utilities
│   ├── database.ts     # SQLite database layer
│   └── startup.ts      # Application initialization
├── types/              # TypeScript definitions
├── public/             # Static assets
├── .cron-version      # Version tracking for upgrades
└── package.json        # Project configuration

Database Storage

The platform uses SQLite for data persistence:

• Development: cron_tasks.db in project root
• Production: data/cron_tasks.db (configurable via environment)

Contributing

This is an open-source project. Contributions are welcome!

License

MIT

Need help? Open an issue on GitHub or check the documentation in your generated project.