Interactive Redis: A Cli for Redis with AutoCompletion and Syntax Highlighting.
IRedis is a terminal client for redis with auto-completion and syntax highlighting. IRedis lets you type Redis commands smoothly, and displays results in a user-friendly format.
IRedis is an alternative for redis-cli. In most cases, IRedis behaves exactly
the same as redis-cli. Besides, it is safer to use IRedis on production servers
than redis-cli: IRedis will prevent accidentally running dangerous commands,
KEYS * (see
Redis docs / Latency generated by slow commands).
- Advanced code completion. If you run command
DEL, IRedis will auto-complete your command based on
- Command validation. IRedis will validate command while you are typing, and
highlight errors. E.g. try
CLUSTER MEET IP PORT, IRedis will validate IP and PORT for you.
- Command highlighting, fully based on redis grammar. Any valid command in IRedis shell is a valid redis command.
- Human-friendly result display.
pipeline feature, you can use your favorite shell tools to parse redis'
get json | jq ..
- Support pager for long output.
- Support connection via URL,
iredis --url redis://example.com:6379/1.
- Support cluster, IRedis will auto reissue command for
MOVEDresponse in cluster mode.
- Store server configuration:
iredis -d prod-redis(see dsn for more).
peekcommand to check the key's type then automatically call
sscan, etc, depending on types. You don't need to call the
typecommand then type another command to get the value.
peekwill also display the key's length and memory usage.
- Ctrl + C to cancel the current typed command, this won't exit IRedis, exactly like bash behaviour. Use Ctrl + D to send a EOF to exit IRedis.
- Ctrl + R to open reverse-i-search to search through your command history.
- Auto suggestions. (Like fish shell.)
--encode=utf-8, to decode Redis' bytes responses.
- Command hint on bottom, include command syntax, supported redis version, and time complexity.
- Official docs with built-in
- Written in pure Python, but IRedis was packaged into a single binary with PyOxidizer, you can use cURL to download and run, it just works, even you don't have a Python interpreter.
- Hide password for
- Says "Goodbye!" to you when you exit!
- For full features, please see: iredis.io
Install via pip:
pip install iredis
pipx is recommended:
pipx install iredis
For Mac users, you can install iredis via brew
brew install iredis
You can also use your Linux package manager to install IRedis, like
Ubuntu (Only available on Ubuntu 21.04+).
apt install iredis
Or you can download the executable binary with cURL(or wget), untar, then run. It is especially useful when you don't have a python interpreter(E.g. the official Redis docker image which doesn't have Python installed.):
wget https://github.com/laixintao/iredis/releases/latest/download/iredis.tar.gz \ && tar -xzf iredis.tar.gz \ && ./iredis
(Check the release page if you want to download an old version of IRedis.)
Once you install IRedis, you will know how to use it. Just remember, IRedis
supports similar options like redis-cli, like
-h for redis-server's host and
-p for port.
$ iredis --help Usage: [OPTIONS] [CMD]... IRedis: Interactive Redis When no command is given, IRedis starts in interactive mode. Examples: - iredis - iredis -d dsn - iredis -h 127.0.0.1 -p 6379 - iredis -h 127.0.0.1 -p 6379 -a <password> - iredis --url redis://localhost:7890/3 Type "help" in interactive mode for information on available commands and settings. Options: -h TEXT Server hostname (default: 127.0.0.1). -p TEXT Server port (default: 6379). -s, --socket TEXT Server socket (overrides hostname and port). -n TEXT Database number.(overwrites dsn/url's db number) -a, --password TEXT Password to use when connecting to the server. --url TEXT Use Redis URL to indicate connection(Can set with env `IREDIS_URL`), Example: redis://[[username]:[password]]@localhost:6379/0 rediss://[[username]:[password]]@localhost:6379/0 unix://[[username]:[password]]@/path/to/socket.soc k?db=0 -d, --dsn TEXT Use DSN configured into the [alias_dsn] section of iredisrc file. (Can set with env `IREDIS_DSN`) --newbie / --no-newbie Show command hints and useful helps. --iredisrc TEXT Config file for iredis, default is ~/.iredisrc. --decode TEXT decode response, default is No decode, which will output all bytes literals. --client_name TEXT Assign a name to the current connection. --raw / --no-raw Use raw formatting for replies (default when STDOUT is not a tty). However, you can use --no- raw to force formatted output even when STDOUT is not a tty. --rainbow / --no-rainbow Display colorful prompt. --shell / --no-shell Allow to run shell commands, default to True. --pager / --no-pager Using pager when output is too tall for your window, default to True. --version Show the version and exit. --help Show this message and exit.
IRedis support storing server configuration in config file. Here is a DSN config:
[alias_dsn] dev=redis://localhost:6379/4 staging=redis://username:email@example.com:6379/1
Put this in your
iredisrc then connect via
iredis -d staging or
iredis -d dev.
IRedis supports config files. Command-line options will always take precedence over config. Configuration resolution from highest to lowest precedence is:
- Options from command line
~/.iredisrc(this path can be changed with
iredis --iredisrc $YOUR_PATH)
- default config in IRedis package.
You can copy the self-explained default config here:
And then make your own changes.
(If you are using an old versions of IRedis, please use the config file below, and change the version in URL):
IRedis support unix/readline-style REPL keyboard shortcuts, which means keys like Ctrl + F to forward work.
Ctrl + D (i.e. EOF) to exit; you can also use the
Ctrl + L to clear screen; you can also use the
- Ctrl + X Ctrl + E to open an editor to edit command, or V in vi-mode.
IRedis is built and released by
GitHub Actions. Whenever a tag is pushed to
master branch, a new release is built and uploaded to pypi.org, it's very
Thus, we release as often as possible, so that users can always enjoy the new features and bugfixes quickly. Any bugfix or new feature will get at least a patch release, whereas big features will get a minor release.
IRedis favors poetry as package management tool. To setup a develop environment on your computer:
First, install poetry (you can do it in a python's virtualenv):
pip install poetry
Then run (which is similar to
pip install -e .):
Be careful running testcases locally, it may flush you db!!!
This is a command-line tool, so we don't write logs to stdout.
tail -f ~/.iredis.log to see logs, the log is pretty clear, you can
see what actually happens from log files.
Catch Up with Latest Redis-doc
IRedis use a git submodule to track current-up-to-date redis-doc version. To catch up with latest:
- Git pull in redis-doc
- Copy doc files to
cp -r redis-doc/commands* iredis/data
prettier --prose-wrap always iredis/data/commands/*.md --write
- Check the diff, update IRedis' code if needed.
If you like iredis, you may also like other cli tools by dbcli:
- pgcli - Postgres Client with Auto-completion and Syntax Highlighting
- mycli - MySQL/MariaDB/Percona Client with Auto-completion and Syntax Highlighting
- litecli - SQLite Client with Auto-completion and Syntax Highlighting
- mssql-cli - Microsoft SQL Server Client with Auto-completion and Syntax Highlighting
- athenacli - AWS Athena Client with Auto-completion and Syntax Highlighting
- vcli - VerticaDB client
- iredis - Client for Redis with AutoCompletion and Syntax Highlighting