# lazycelery

> Terminal UI for monitoring and managing Celery workers, queues, and tasks with real-time updates and keyboard navigation.

Stars: 56 · Language: Rust · License: MIT · Categories: Dev Tools

- Repository: https://github.com/fguedes90/lazycelery
- Website: https://github.com/Fguedes90/lazycelery
- Page: https://www.trmn.sh/tools/lazycelery

## Install

- Homebrew: `brew tap Fguedes90/tap && brew install lazycelery`
- Cargo: `cargo install lazycelery`
- Scoop: `scoop bucket add lazycelery https://github.com/Fguedes90/scoop-bucket.git && scoop install lazycelery`

## Overview

LazyCelery is a terminal user interface for monitoring and managing Celery distributed task systems. It provides real-time visibility into worker status, queue management with message counts, and task tracking across different execution states. The tool uses a keyboard-driven interface similar to lazydocker and lazygit, allowing developers to navigate between workers, queues, and tasks using tab switching and vim-style key bindings.

The application connects to Redis or other Celery message brokers to gather metrics and display them in an organized dashboard format. It includes search and filtering capabilities across all views, enabling users to quickly locate specific workers or tasks. LazyCelery automatically manages configuration files and provides interactive setup commands for initial broker configuration.

Developers working with Celery-based applications can use this tool to debug task execution, monitor worker health, and manage queue backlogs without switching between multiple command-line tools or web interfaces. The tool supports custom broker URLs, configurable refresh intervals, and provides helpful error messages for common connection issues.

### Installation

```bash
# via Homebrew
brew tap Fguedes90/tap && brew install lazycelery
```

```bash
# via Cargo
cargo install lazycelery
```

```bash
# via Scoop
scoop bucket add lazycelery https://github.com/Fguedes90/scoop-bucket.git && scoop install lazycelery
```

![Workers dashboard view](https://media.trmn.sh/cached/2fb1068bcfd1f87f718a4b1b546766c0d94439dbce12ae3f5a3e431b39586066.png)

![Queue management view](https://media.trmn.sh/cached/0f8ee389517f0c04ab949b1e4affb2883ed86cb9201cb6a730978fa457dfcab5.png)

![Tasks monitoring view](https://media.trmn.sh/cached/f9561d577b40c4e6a5a75ab35f9f525f68e8876eacbdedf5e773b63f030afa31.png)

## Alternatives

- [termframe](https://www.trmn.sh/tools/termframe.md): Non-interactive terminal emulator that executes commands and exports their output as SVG screenshots. (Rust, 144 stars)
- [logss](https://www.trmn.sh/tools/logss.md): CLI tool that splits and visualizes log streams into multiple containers based on regex patterns with real-time filtering (Rust, 296 stars)
- [dra](https://www.trmn.sh/tools/dra.md): CLI tool to download and install release assets from GitHub repositories (Rust, 364 stars)
- [Railway CLI](https://www.trmn.sh/tools/railway-cli.md): Command-line client for Railway projects: deploy with `railway up`, manage IaC config, configure AI agent tools via MCP, and launch cloud agent VMs. (Rust, 628 stars)
- [tlrc](https://www.trmn.sh/tools/tlrc.md): Official tldr-pages client written in Rust that shows community-maintained command cheat sheets in the terminal, with a local cache and a TOML config. (Rust, 1.1k stars)

---

Canonical: https://www.trmn.sh/tools/lazycelery