Repolode
Submit
laixintao

laixintao/iredis

A terminal client for Redis with auto-completion, syntax highlighting, and human-friendly output, designed as a drop-in alternative to redis-cli.

Open-source alternative to:redis-cli

View on GitHubWebsite
Stars
2,762
Forks
118
Open issues
49
Last commit
5 days ago

What is it?

IRedis is an interactive command-line client for Redis. It behaves largely like redis-cli, with the same common options such as -h, -p and -a, but adds command completion, validation while typing, and formatted result display. Completion can draw on earlier results, for example suggesting keys returned by KEYS when you type DEL next.

It includes safety measures for production use, such as blocking dangerous commands like KEYS *. Connections can be made by URL, through named DSN aliases stored in a config file, or over Redis Cluster with NAT address mapping via --natmap. The peek command checks a key's type and automatically fetches its value, along with its length and memory usage.

IRedis runs on Python 3.10 to 3.14 and can be installed with pip, Homebrew, or apt on Ubuntu 21.04+. Built-in HELP output shows command syntax, supported Redis version and time complexity.

Key features

  • 01Auto-completion that uses results from earlier commands, such as keys returned by KEYS.
  • 02Validates commands as you type and highlights errors, based on Redis grammar.
  • 03The peek command fetches a key's value by its type, along with length and memory usage.
  • 04Connects by URL, named DSN aliases in a config file, or Redis Cluster with --natmap address mapping.
  • 05Pipes command output to shell tools like jq, and supports a pager for long output.

Use cases

  • Working with Redis on a daily basis and wanting autocomplete and colored output instead of plain redis-cli.
  • Running Redis commands against production servers with protection against slow commands like KEYS *.
  • Accessing a Redis Cluster through SSH tunnels or port forwarding where node addresses need translation.
  • Scripting Redis queries by piping commands into iredis from a shell.

Quick start

  1. 1

    Install via pip

    pip install iredis
  2. 2

    Start the interactive session

    iredis

Things to know

  • Requires a Python interpreter (3.10 to 3.14) unless you use the older standalone binary.
  • Single-binary builds stopped after v1.15.2 because PyOxidizer is no longer maintained.

In collections

CLI & terminal tools

Topics

#redis#command-line-tool#redis-client#terminal#autocompletion#syntax-highlighting#redis-cli

FAQ

What is iredis?
A terminal client for Redis with auto-completion, syntax highlighting, and human-friendly output, designed as a drop-in alternative to redis-cli. IRedis is an interactive command-line client for Redis. It behaves largely like redis-cli, with the same common options such as -h, -p and -a, but adds command completion, validation while typing, and formatted result display. Completion can draw on earlier results, for example suggesting keys returned by KEYS when you type DEL next.
Is iredis free to use? What license does it have?
iredis is open source under the BSD-3-Clause license. Check the license terms before using it in commercial products.
Is iredis still maintained?
Actively maintained. The last commit to iredis was on Nov 2, 2026.
What can I use iredis for?
Working with Redis on a daily basis and wanting autocomplete and colored output instead of plain redis-cli. Running Redis commands against production servers with protection against slow commands like KEYS *. Accessing a Redis Cluster through SSH tunnels or port forwarding where node addresses need translation. Scripting Redis queries by piping commands into iredis from a shell.
How do I install iredis?
Install via pip: pip install iredis Start the interactive session: iredis
Where can I get iredis?
The source code and installation instructions are on GitHub: https://github.com/laixintao/iredis

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects