Redis TUI Manager

A feature-rich terminal UI for managing Redis databases, built with Go and Bubble Tea. Browse, edit, and monitor your Redis keys without leaving the terminal.

Quick Install

# Native install — recommended (macOS and Linux)
curl -fsSL https://raw.githubusercontent.com/davidbudnick/redis-tui/main/install.sh | bash

# Homebrew (macOS and Linux)
brew tap davidbudnick/homebrew-tap
brew install --cask redis-tui

# Go (requires Go 1.26+)
go install github.com/davidbudnick/redis-tui@latest

Pre-built binaries — Download from GitHub Releases

Screenshots

Key Browser with Preview

Live Metrics Dashboard

Features

Browsing and Editing

• Key browser with pattern filtering, regex, and fuzzy search
• All data types — strings, lists, sets, sorted sets, hashes, streams, JSON (RedisJSON), HyperLogLog, bitmaps, and geospatial
• Inline value editor for editing string and JSON values
• Tree view for hierarchical key navigation
• Favorites and recent keys for quick access
• Key templates for creating keys from predefined structures
• Value history — view and restore previous values
• JSON syntax highlighting

Connections and Security

• CLI quick connect — pass --host, --port, --user, --password, etc. to connect without a config file
• Connection manager — save and switch between multiple Redis instances
• TLS/SSL encryption support
• SSH tunneling for secure remote access
• Connection groups to organize instances
• Database switching between Redis databases (0-15)
• Cluster support — connect to any cluster node and press K to view all nodes, their roles (master/replica), slot ranges, and link state; cluster metrics in the live dashboard

Monitoring and Operations

• Live metrics dashboard — real-time ops/sec, memory, CPU, network I/O, hit rate, and client count with scrolling ASCII charts; cluster node count display
• Server info — version, mode, OS, uptime, memory, and connected clients
• Memory stats — detailed usage breakdown and top keys by memory consumption
• Slow log — view slow query entries with execution time and command details
• Client list — view all connected Redis clients with address, age, and command info
• Watch mode — monitor key values for changes in real-time with configurable interval
• Keyspace events — subscribe to keyspace notifications (set, del, expire, etc.)
• Export/Import — JSON-based key backup and restore
• Bulk operations — pattern-based delete and batch TTL across multiple keys
• Redis config — browse and edit runtime CONFIG parameters
• Pub/Sub — browse active channels with subscriber counts and publish messages
• Lua scripting — execute Lua scripts directly against the server
• Themes — switch between color themes

Installation

Native Install (Recommended)

The install script auto-detects your OS and architecture, downloads the latest release, verifies the checksum, and installs the binary to ~/.local/bin (override with INSTALL_DIR):

curl -fsSL https://raw.githubusercontent.com/davidbudnick/redis-tui/main/install.sh | bash

# Custom install directory
INSTALL_DIR=/usr/local/bin curl -fsSL https://raw.githubusercontent.com/davidbudnick/redis-tui/main/install.sh | bash

Homebrew

See Quick Install above.

From Source

# Clone the repository
git clone https://github.com/davidbudnick/redis-tui.git
cd redis-tui

# Build
make build

# Install to GOPATH/bin
make install

Pre-built Binaries

Download the latest release from the Releases page. Pre-built binaries are available for macOS, Linux, and Windows with no Go installation required.

Using Go Install

Note: Requires Go 1.26 or later.

go install github.com/davidbudnick/redis-tui@latest

Usage

# Launch the interactive connection manager
redis-tui

# Quick connect to a Redis server
redis-tui --host localhost

# Connect with password and specific database
redis-tui -h redis.example.com -p 6380 -a mypassword -n 2

# Connect to a cluster node
redis-tui --host redis.example.com --port 6380 --cluster

# Connect with TLS
redis-tui --host redis.example.com --tls --tls-ca /path/to/ca.pem

# Update to the latest version
redis-tui --update

When --host is provided the TUI connects automatically on startup. Without flags the interactive connection manager is shown.

Press ? inside the app to view the full help screen.

CLI Flags

Short flags (-h, -p, -a, -n) follow redis-cli conventions.

Uninstall

# Native install
rm -f ~/.local/bin/redis-tui

# Homebrew
brew uninstall --cask redis-tui

# Go
rm -f $(go env GOPATH)/bin/redis-tui

Keyboard Shortcuts

Global

Connections Screen

Keys Screen

Key Detail Screen

Docker Compose Examples

Need a Redis instance to try redis-tui? Docker Compose files are included under examples/.

# Standalone Redis on port 6379
docker compose -f examples/standalone/docker-compose.yml up -d
redis-tui -h localhost

# 6-node cluster (3 masters + 3 replicas) on ports 6380-6385
docker compose -f examples/cluster/docker-compose.yml up -d
redis-tui -h localhost -p 6380 --cluster

# Standalone Redis Stack (RedisJSON, RediSearch, etc.) on port 6390
docker compose -f examples/standalone-redis-stack/docker-compose.yml up -d
redis-tui -h localhost -p 6390

# Redis Stack cluster on ports 6386-6392
docker compose -f examples/cluster-redis-stack/docker-compose.yml up -d
redis-tui -h localhost -p 6386 --cluster

The Makefile also exposes shortcuts for these (make docker-up-standalone, make docker-up-cluster, make docker-up-standalone-stack, make docker-up-cluster-stack) along with matching docker-down-* and docker-seed-* targets.

Configuration

Configuration is stored in ~/.config/redis-tui/config.json.

Example Configuration

```json { "connections": [ { "id": 1, "name": "Standalone", "host": "localhost", "port": 6379, "username": "default", "db": 0, "created_at": "2025-01-01T00:00:00Z", "updated_at": "2025-01-01T00:00:00Z" }, { "id": 2, "name": "Cluster", "host": "localhost", "port": 6380, "db": 0, "use_cluster": true, "created_at": "2025-01-01T00:00:00Z", "updated_at": "2025-01-01T00:00:00Z" } ], "groups": [ { "name": "local", "color": "#50fa7b", "connections": [1, 2] } ], "favorites": [ { "connection_id": 1, "connection": "Standalone", "key": "app:config", "label": "App Settings", "added_at": "2025-01-15T10:30:00Z" } ], "recent_keys": [ { "connection_id": 1, "key": "session:abc123", "type": "hash", "accessed_at": "2025-01-20T14:00:00Z" } ], "templates": [ { "name": "Session", "description": "User session data", "key_pattern": "session:{user_id}", "type": "hash", "default_ttl": 86400000000000, "fields": { "token": "", "created_at": "", "user_agent": "" } }, { "name": "Cache", "description": "Cached data with TTL", "key_pattern": "cache:{resource}:{id}", "type": "string", "default_ttl": 3600000000000 }, { "name": "Rate Limit", "description": "Rate limiting counter", "key_pattern": "ratelimit:{ip}:{endpoint}", "type": "string", "default_ttl": 60000000000, "default_value": "0" }, { "name": "Queue", "description": "Job queue", "key_pattern": "queue:{name}", "type": "list" }, { "name": "Leaderboard", "description": "Sorted leaderboard", "key_pattern": "leaderboard:{game}", "type": "zset" } ], "tree_separator": ":", "max_recent_keys": 20, "max_value_history": 50, "watc