lazycelery 0.4.0

A terminal UI for monitoring and managing Celery workers and tasks, inspired by lazydocker/lazygit
Documentation

LazyCelery

CI Release License: MIT Crates.io

A terminal UI for monitoring and managing Celery workers and tasks, inspired by lazydocker and lazygit.

Features

  • Real-time worker monitoring
  • Queue management with message counts
  • Task listing with status tracking
  • Search and filter capabilities
  • Keyboard-driven interface

Screenshots

Main Dashboard - Workers View

Workers View

Queue Management

Queues View

Task Monitoring

Tasks View

Search Mode

Search Mode

Help Screen

Help Screen

Installation

Choose your preferred installation method:

🦀 Cargo (Rust)

cargo install lazycelery

🍺 Homebrew (macOS/Linux)

brew tap Fguedes90/tap
brew install lazycelery

📦 Arch Linux (AUR)

# Source package (builds from source)
yay -S lazycelery

# Binary package (faster install)
yay -S lazycelery-bin

🪣 Scoop (Windows)

scoop bucket add lazycelery https://github.com/Fguedes90/scoop-bucket.git
scoop install lazycelery

🍫 Chocolatey (Windows)

choco install lazycelery

📱 Snap (Linux)

snap install lazycelery

📥 Binary Download

Download pre-built binaries from GitHub Releases:

  • Linux x86_64: lazycelery-linux-x86_64.tar.gz
  • macOS x86_64: lazycelery-macos-x86_64.tar.gz
  • macOS ARM64: lazycelery-macos-aarch64.tar.gz
  • Windows x86_64: lazycelery-windows-x86_64.zip

🔧 From Source

# Clone the repository
git clone https://github.com/fguedes90/lazycelery.git
cd lazycelery

# Install mise (task runner)
./scripts/install-mise.sh

# Setup development environment
mise run setup

# Build release binary
mise run release

Usage

# Connect to Redis broker
lazycelery --broker redis://localhost:6379/0

# Use configuration file
lazycelery --config ~/.config/lazycelery/config.toml

Keyboard Shortcuts

  • Tab - Switch between Workers/Queues/Tasks
  • ↑/↓ or j/k - Navigate items
  • / - Search mode
  • ? - Show help
  • q - Quit

Development

Prerequisites

  • Rust 1.70.0 or later
  • Redis (for testing)
  • mise (task runner)

Quick Start

# Install mise if you haven't already
./scripts/install-mise.sh

# Setup development environment
mise run setup

# Run with auto-reload
mise run dev

# Run tests in watch mode
mise run test-watch

Available Tasks

mise tasks              # Show all available tasks
mise run build         # Build release binary
mise run dev           # Run with auto-reload
mise run test          # Run tests
mise run lint          # Run linter
mise run fmt           # Format code
mise run audit         # Security audit
mise run coverage      # Generate coverage report
mise run docs          # Generate documentation

Pre-commit Checks

Before committing, run:

mise run pre-commit

This runs formatting, linting, tests, and security audit.

Contributing

See CONTRIBUTING.md for guidelines.

Specifications

See specs/ directory for detailed specifications and planned features.