redis

Redis CLI

A standalone, feature-rich Redis interactive CLI client for Go applications.

Features

• 🚀 Full Redis protocol support
• 🔧 Customizable connection parameters
• 🔒 TLS/SSL support
• 💾 Connection pooling with configurable size
• ⏱️ Query timing
• 🔄 Transaction support (MULTI/EXEC/DISCARD)
• 📝 Command history
• 🎯 Database selection
• 👤 Redis 6.0+ ACL username support

Installation

go get github.com/binrchq/redis-cli

Quick Start

package main

import (
    "log"
    "os"
    
    rediscli "github.com/binrchq/redis-cli"
)

func main() {
    cli := rediscli.NewCLI(
        os.Stdin,
        "localhost",
        6379,
        "password",
    )
    
    if err := cli.Connect(); err != nil {
        log.Fatal(err)
    }
    defer cli.Close()
    
    if err := cli.Start(); err != nil {
        log.Fatal(err)
    }
}

Advanced Configuration

config := &rediscli.Config{
    Host:         "localhost",
    Port:         6379,
    Password:     "password",
    DB:           0,
    DialTimeout:  15 * time.Second,
    ReadTimeout:  60 * time.Second,
    WriteTimeout: 60 * time.Second,
    PoolSize:     20,
    MinIdleConns: 5,
    MaxRetries:   5,
    Username:     "default", // Redis 6.0+
    TLSEnabled:   true,
}

cli := rediscli.NewCLIWithConfig(terminal, config)

Supported Commands

All Redis commands are supported including:

String Commands

• GET, SET, INCR, DECR, APPEND

Hash Commands

• HGET, HSET, HGETALL, HDEL

List Commands

• LPUSH, RPUSH, LPOP, RPOP, LRANGE

Set Commands

• SADD, SREM, SMEMBERS, SISMEMBER

Sorted Set Commands

• ZADD, ZRANGE, ZRANK, ZSCORE

Key Commands

• KEYS, DEL, EXISTS, TTL, EXPIRE

Transaction Commands

• MULTI, EXEC, DISCARD

Special Commands

• help - Show help
• exit, quit - Exit CLI
• timing - Toggle timing
• SELECT <db> - Switch database
• conninfo - Show connection info

Requirements

• Go 1.21 or higher
• Redis 5.0 or higher

Dependencies

• github.com/redis/go-redis/v9 - Redis client
• github.com/chzyer/readline - Readline library

License

MIT License - see LICENSE file for details.

Author

Maintained by binrc.

Related Projects

• mysql-cli - MySQL CLI
• postgres-cli - PostgreSQL CLI
• mongodb-cli - MongoDB CLI