A terminal user interface for browsing and managing Redis data.

• Tree-based navigation of Redis keys
• Support for all Redis data types (strings, lists, sets, hashes, sorted sets)
• Pattern-based filtering
• Data type filtering
• TTL display and management
• Basic Redis operations (view, edit, delete)
• Search functionality
• Configurable Redis connection

Using Homebrew:

brew install redis
brew services start redis

• Linux: Redis Installation Guide for Linux
• Windows: Redis Installation Guide for Windows
• Docker: docker run --name redis -p 6379:6379 -d redis

redis-cli ping

If you see PONG as the response, Redis is running correctly!

1. Clone the repository:

git clone https://github.com/gregk/redis_tui.git
cd redis_tui

2. Create and activate a virtual environment:

python3 -m venv venv
source venv/bin/activate  # On macOS/Linux

3. Install in development mode:

pip install -e .

pip install redis-tui

There are two ways to run Redis TUI:

1. Using the installed command:

redis-tui

2. Running the module directly:

python -m src.app

Connect to a specific Redis instance:

redis-tui --host localhost --port 6379 --db 0

Or when running as a module:

python -m src.app --host localhost --port 6379 --db 0

Load sample data for testing/demo purposes:

redis-tui --samples

• ↑/↓: Navigate keys
• ←/→: Collapse/expand tree nodes
• Enter: Select key
• f: Toggle between key tree and data view
• d: Toggle raw data view
• q: Quit
• r: Refresh data

Redis connection details can be provided via:

1. Command line arguments
2. Environment variables:

   export REDIS_HOST=localhost
   export REDIS_PORT=6379
   export REDIS_DB=0

3. Configuration file:

   # ~/.config/redis-tui/config.yaml
   redis:
     host: localhost
     port: 6379
     db: 0

1. Clone the repository:

git clone https://github.com/yourusername/redis-tui.git
cd redis-tui

2. Create and activate a virtual environment:

python3 -m venv venv
source venv/bin/activate  # On macOS/Linux

3. Install development dependencies:

pip install -e ".[dev]"

Contributions are welcome! Please see our contributing guidelines for more details.

MIT License