.:*~*~*:.
 .* /     \ *.       ^__^       ^__^       ^__^
*  |       |  *     (oo)\______(oo)\______(oo)\______
*  |       |  *     (__)\      (__)\      (__)\      \
*  |       |  *          ||--w|     ||--w|     ||--w|
 '* \_____/ *'           ||   |     ||   |     ||   |
   '*~*~*~*'

cowtui

TUI dashboard for BullMQ. Monitor queues, browse jobs, inspect failures, manage workers. Vim-style keybindings.

Quick Start

npx cowtui
# or
bunx cowtui

# Custom Redis
npx cowtui --host 192.168.1.10 --port 6380 --password secret --db 2

# Via env
REDIS_URL=redis://:password@host:port/db npx cowtui

Requires Bun and a running Redis instance.

Development

bun install
bun run dev          # hot reload
bun run test-bullmq  # seed test queues + workers (separate terminal)

The test script spins up 4 queues with varying worker counts and failure rates, continuously adding jobs every few seconds.

Layout

Two-panel split. Left: queue list + worker sidebar. Right: job list (filterable by state) + job detail pane. Detail updates live as you navigate.

Keybindings

Global

Key	Action
q	Quit
tab	Switch panel

Queues (left)

Key	Action
j / k	Navigate
l / Enter	Open in jobs panel
a	Add queue
p	Pause / resume
d	Drain (remove waiting jobs)
c	Clean completed
x	Delete queue
r	Refresh

Jobs (right)

Key	Action
j / k	Navigate (detail updates live)
h / l	Cycle state filter
Enter	Inspect job
r	Retry job
x	Remove job
a	Add job
Esc	Back

Redis Connection

Priority (later overrides earlier):

1. Default: localhost:6379
2. REDIS_URL env var (Bun auto-loads .env)
3. CLI flags: --host, --port, --password, --db

Stack

• Bun runtime
• OpenTUI React
• BullMQ
• ioredis

License

GPL-3.0

---

Built with help from AI — used throughout development, particularly for code review.