Redis Fundamentals Agent

Overview

Production-grade agent for Redis fundamentals. Provides comprehensive guidance on installation, CLI operations, core concepts, and practical use cases with full error handling and observability.

Core Capabilities

1. Redis Installation & Setup

capabilities:
  - platform: [linux-debian, linux-rhel, macos, windows-wsl2, docker, kubernetes]
  - methods: [package-manager, source-build, container, helm-chart]
  - verification: automated-health-check

Commands:

# Quick install verification
redis-cli ping  # Expected: PONG

# Version check
redis-server --version

# Config location
redis-cli CONFIG GET dir

2. Core Concepts

Concept	Description	Production Impact
In-memory	All data in RAM	Sub-ms latency
Single-threaded	Event loop model	No lock contention
Persistence	RDB/AOF options	Durability vs speed
Replication	Master-replica	HA & read scaling

3. CLI Operations

# Connection with auth
redis-cli -h <host> -p <port> -a <password>

# Basic operations
SET key "value" EX 3600      # With 1-hour TTL
GET key
DEL key
EXISTS key                    # Returns 1 or 0
TTL key                       # Remaining seconds

4. Use Case Decision Tree

┌─────────────────────────────────────────────────────────┐
│ What's your primary need?                               │
├─────────────────────────────────────────────────────────┤
│ ├── Caching? ──────────────────> String + TTL           │
│ ├── Session storage? ──────────> Hash + TTL             │
│ ├── Rate limiting? ────────────> String + INCR + EXPIRE │
│ ├── Leaderboard? ──────────────> Sorted Set             │
│ ├── Message queue? ────────────> List or Stream         │
│ └── Real-time analytics? ──────> HyperLogLog + Bitmap   │
└─────────────────────────────────────────────────────────┘

Example Prompts

"Install Redis using Docker and test basic operations"
"Explain Redis single-threaded architecture benefits"
"Set up Redis for session caching in my Node.js app"
"What are the key differences between Redis and Memcached?"

Related Skills

redis-installation - Detailed installation guides (PRIMARY_BOND)
redis-strings - String data type operations

Learning Path

Level	Duration	Topics	Milestone
Beginner	2-4h	Install, SET/GET, TTL	First cache hit
Intermediate	4-8h	Data types, pipelining	10K ops/sec
Advanced	8+h	Lua scripts, modules	Production deploy

Troubleshooting Guide

Common Issues & Solutions

1. Connection Refused

Error: Could not connect to Redis at 127.0.0.1:6379

Diagnosis:

# Check if Redis is running
systemctl status redis-server  # Linux
brew services list | grep redis  # macOS
docker ps | grep redis  # Docker

# Check port binding
netstat -tlnp | grep 6379
ss -tlnp | grep 6379

Solutions:

Cause	Fix
Redis not running	`systemctl start redis-server`
Wrong port	Check `redis.conf` for `port` setting
Firewall blocking	`ufw allow 6379/tcp`
Bind to localhost only	Set `bind 0.0.0.0` in config

2. Authentication Failed

Error: NOAUTH Authentication required

Fix:

# Connect with password
redis-cli -a yourpassword

# Or via AUTH command
redis-cli
AUTH yourpassword

3. Memory Issues

Error: OOM command not allowed when used memory > 'maxmemory'