@alex-programmer/cron NPM

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/cron@0.0.4-alpha 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