A terminal UI for monitoring and managing Celery workers and tasks, inspired by lazydocker and lazygit.
- Real-time worker monitoring
- Queue management with message counts
- Task listing with status tracking
- Search and filter capabilities
- Keyboard-driven interface
- Interactive CLI configuration with subcommands
- Automatic configuration file management
- Helpful error messages and setup guidance
Choose your preferred installation method:
cargo install lazycelerybrew tap Fguedes90/tap
brew install lazyceleryscoop bucket add lazycelery https://github.com/Fguedes90/scoop-bucket.git
scoop install lazyceleryDownload 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
# 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# Run interactive setup
lazycelery init
# Or start with default Redis configuration
lazycelery --broker redis://localhost:6379/0LazyCelery provides several subcommands to manage your configuration without editing files:
# Initialize configuration with interactive setup
lazycelery init
# Show current configuration
lazycelery config
# Update broker URL
lazycelery set-broker redis://localhost:6379/0
# Update refresh interval (milliseconds)
lazycelery set-refresh 2000# Use configured settings
lazycelery
# Override broker URL
lazycelery --broker redis://localhost:6379/0
# Use custom config file
lazycelery --config ~/.config/lazycelery/config.tomlIf you encounter connection errors, LazyCelery provides helpful setup instructions:
-
Start Redis (choose one):
# Docker docker run -d -p 6379:6379 redis # macOS brew services start redis # Linux sudo systemctl start redis
-
Verify Redis is running:
redis-cli ping
-
Run LazyCelery:
lazycelery --broker redis://localhost:6379/0
Tab- Switch between Workers/Queues/Tasks↑/↓orj/k- Navigate items/- Search mode?- Show helpq- Quit
- Rust 1.70.0 or later
- Redis (for testing)
- mise (task runner)
# 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-watchmise 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 documentationBefore committing, run:
mise run pre-commitThis runs formatting, linting, tests, and security audit.
See CONTRIBUTING.md for guidelines.
This project is licensed under the MIT License - see the LICENSE file for details.