⏳ humancron

The elite, zero-friction CLI to translate, predict, and visually build cron expressions.

Ever stared at a string like */15 * * * 6,0 and wondered if it runs on weekends, every 15 days, or both? We've all been there.

humancron takes the guesswork out of scheduled tasks. It instantly translates cryptic cron expressions into human-readable text, predicts the next 10 exact execution dates, and even provides a stunning interactive terminal UI to generate new expressions from scratch. No quotes, no friction.

✨ Features

• 🗣️ Human Translation: Converts complex cron strings into readable text (English & Spanish).
• 🔮 Time Prediction: Calculates and displays the next 10 exact execution dates so you know exactly when your job will run.
• 🖥️ Interactive Builder: A beautiful, keyboard-navigable UI to generate cron expressions step-by-step with hybrid custom inputs.
• 🛡️ Zero-Friction DX: Built with a smart argument assembler—no need to wrap your cron expressions in annoying quotes.
• 💾 File Export: Save your temporal analysis directly to a .txt file for logs, team communication, and reports.

📦 Installation

You can run it instantly using your favorite package manager, or install it globally to have it always available in your terminal:

# Run instantly with NPX
npx @elilands/humancron g

# Install globally (Recommended)
npm install -g @elilands/humancron

🚀 Usage

humancron is designed to be ridiculously simple. Just open your terminal and run:

1. Translate & Predict (The Command You Want)

Instantly translate a cron expression and see its next 10 runs. No quotes needed!

humancron translate 0 12 * * *

(You can also use the short alias t)

humancron t */15 * * * 1-5

Want it in Spanish or exported to a file? Use the --lang flag (supports en and es) and the --export flag to save a clean text report.

humancron t */15 * * * 6,0 --lang es --export my-report.txt

2. Interactive Generator

Don't remember the cron syntax at all? Let the visual builder guide you. Navigate with your arrow keys, choose standard intervals, or type your own custom values.

humancron generate

(Or use the short alias)

humancron g

🤝 Contributing

Found a bug or have an idea to make this better? PRs are always welcome!

1. Clone the repo.
2. Run npm install.
3. Make your changes in the src/ directory.
4. Run npm run build to compile the ESM code and test your changes.
5. Submit your PR!

📄 License

MIT License. Built for developers, by developers.