Redis Viewer

April 20, 2026 · View on GitHub

redis-viewer is a terminal UI for browsing Redis keys and inspecting values.

Redis Viewer UI

Built with Bubble Tea.

Features

  • Browse Redis keys in a terminal UI
  • Inspect string, hash, list, set, and zset values
  • Search keys with Redis SCAN match patterns
  • Paginate through matched keys

Install

Go install

Requires Go 1.25 or newer:

go install github.com/saltfishpr/redis-viewer@latest

Download binary

Download a release from GitHub Releases.

Usage

Show help:

redis-viewer --help

Run with the default config file:

redis-viewer

Run with a specific config file:

redis-viewer --config ./redis-viewer.yaml

Configuration

Default config path:

$HOME/.redis-viewer.yaml

Example:

addrs:
  - 127.0.0.1:6379

db: 0
username: ""
password: ""

# Used for sentinel mode.
master_name: ""

# Number of keys shown per page.
page_size: 20

Notes on connection modes

  • Single node: set one address in addrs
  • Cluster: set multiple cluster node addresses in addrs
  • Sentinel: set sentinel addresses in addrs and set master_name

Keybindings

KeyAction
Ctrl+CQuit
↑ / ↓Move selection
←Previous page
→Next page
rReload current page
sEnter search mode
EnterApply current search
EscCancel search mode

Known Limitations

  • Only string, hash, list, set, and zset are rendered
  • Unsupported key types are shown as errors in the item detail
  • Windows system requires terminal encoding to be set to UTF-8

License

MIT