Crolendar

A modern Terminal User Interface for visualizing and managing cron schedules.

Documentation · Source Code · Report Bug

Why Crolendar?

Crolendar transforms the cryptic syntax of crontabs into a clear, interactive timeline. Designed for developers and sysadmins who live in the terminal and need to visualize automation at a glance.

• Visual Timeline: Stop guessing when your jobs run. View your raw crontab schedules mapped onto a familiar calendar grid.
• Vim-Inspired Navigation: Move through your schedule with lightning speed using standard h/j/k/l motions.
• Auto-Discovery: Automatically attempts to load your system crontab, or falls back to a local crontab.txt for easy testing.
• Lightweight & Fast: Built with Go and the Charm libraries, providing a flicker-free, responsive TUI experience.
• Context Aware: Easily switch focus between different views (Sidebar and Main Grid) to drill down into specific job details.

Installation

Get started quickly by building from source. Ensure you have Go 1.21+ installed.

# Clone the repository
git clone https://github.com/yourusername/crolendar.git

# Navigate to the directory
cd crolendar

# Install dependencies and run
go mod tidy
go run .

Controls

Navigation is designed to be keyboard-centric and intuitive for terminal users.

Component	Shortcut	Action
Global	Tab	Switch focus (Sidebar / Grid)
	q / Ctrl+C	Quit Application
Navigation	h / j / k / l	Move Selection (Left / Down / Up / Right)
	Arrow Keys	Move Selection
View	Enter	Select/Inspect Job

Architecture

Crolendar is built on a modern TUI stack:

• Frontend: Bubble Tea for reactive TUI components.
• Styling: Lipgloss for layout and terminal-based CSS.
• Parsing: Custom Go-based cron parser to handle standard crontab formats.

© CodeFXR. All rights reserved.