Installing the `zedis` executable

Assuming you have Rust/Cargo installed, run this command in a terminal:

cargo install zedis-gui

It will make the zedis command available in your PATH if you've allowed the PATH to be modified when installing Rust. cargo uninstall zedis-gui uninstalls.

Back to the crate overview.

Readme

中文 | English

Zedis

A High-Performance, GPU-Accelerated Redis Client Built with Rust 🦀 and GPUI ⚡️

Zedis

📖 Introduction

Zedis is a next-generation Redis GUI client designed for developers who demand speed.

Unlike Electron-based clients that can feel sluggish with large datasets, Zedis is built on GPUI (the same rendering engine powering the Zed Editor). This ensures a native, 60 FPS experience with minimal memory footprint, even when browsing millions of keys.

📦 Installation

Cargo

cargo install --locked zedis-gui

macOS

The recommended way to install Zedis is via Homebrew:

brew install --cask zedis

Windows

scoop bucket add extras
scoop install zedis

Arch linux

yay -S zedis-bin

✨ Features

🚀 Blazing Fast

GPU Rendering: All UI elements are rendered on the GPU for buttery smooth performance.
Virtual List: Efficiently handle lists with 100k+ keys using virtual scrolling and SCAN iteration.

🧠 Smart Data Viewer

Zedis automatically detects content types (ViewerMode::Auto) and renders them in the most useful format:

Automatic Decompression: Transparently detects and decompresses LZ4, SNAPPY, GZIP, and ZSTD data (e.g., compressed JSON is automatically unpacked and pretty-printed).
JSON: Automatic pretty-printing with full syntax highlighting.
Protobuf: Deserializes Protobuf data and automatically pretty-printing with full syntax highlighting.
MessagePack: Deserializes binary MsgPack data into a readable JSON-like format.
Images: Native preview for stored images (PNG, JPG, WEBP, SVG, GIF).
Hex View: Adaptive 8/16-byte hex dump for analyzing raw binary data.
Text: UTF-8 validation with large text support.

🛡️ Safety & Security

Read-only Mode: Mark connections as Read-only to prevent accidental writes or deletions. Perfect for inspecting production environments with total peace of mind.
SSH Tunneling: Securely access private Redis instances via bastion hosts. Supports authentication via Password, Private Key, and SSH Agent.
TLS/SSL: Full support for encrypted connections, including custom CA, Client Certificates, and Private Keys.

⚡ Productivity

Auto Refresh: Monitor live data with configurable refresh intervals for both Key Lists and Key Values. Perfect for watching active queues or volatile cache data without manual reloading.
Command Autocomplete: Intelligent IntelliSense-style code completion for Redis commands. It provides real-time syntax suggestions and parameter hints based on your Redis server version.
Search History: Automatically records your search queries locally. History is connection-scoped, ensuring production queries never pollute your local development workflow.
Batch Operations: Support selecting multiple keys for batch deletion or deleting keys with a specific prefix to simplify bulk data management.

🎨 Modern Experience

Cross-Platform: Powered by GPUI, Zedis delivers a consistent, native experience across macOS, Windows, and Linux.
Smart Topology Detection: Automatically identifies Standalone, Cluster, or Sentinel modes. Connect to any node, and Zedis handles the topology mapping automatically.
Themes: Pre-loaded with Light, Dark, and System themes.
I18n: Full support for English and Chinese (Simplified).
Responsive: Split-pane layout that adapts to any window size.

🚧 Development Status

Zedis is currently in early active development. To maintain development velocity and architectural flexibility, we are not accepting Pull Requests at this time.

We will open up for contributions once the core architecture stabilizes. Please Star or Watch the repository to stay updated!

📄 License

This project is Licensed under Apache License, Version 2.0.

Installing the zedis executable

Installing the `zedis` executable