/redis-inspect

name: redis-inspect
description: Inspect Redis cache keys, values, and TTLs for debugging. Supports both main cache and system cache. Use for debugging cache issues, checking cached values, and monitoring cache state. Read-only by default.

Redis Cache Inspector

Use this skill to inspect Redis cache state for debugging purposes.

Running Commands

node .claude/skills/redis-inspect/query.mjs <command> [options]

Commands

| Command | Description | |---------|-------------| | `get <key>` | Get a string value | | `keys <pattern>` | Find keys matching pattern (use * as wildcard) | | `ttl <key>` | Get TTL (-1 = no expiry, -2 = not found) | | `type <key>` | Get the type of a key | | `exists <key>` | Check if key exists | | `hgetall <key>` | Get all fields from a hash | | `hget <key> <field>` | Get a specific hash field | | `scard <key>` | Get set cardinality (count) | | `smembers <key>` | Get all set members | | `llen <key>` | Get list length | | `lrange <key>` | Get list elements | | `del <key>` | Delete a key (requires --writable) | | `info` | Get Redis server info |

Options

| Flag | Description | |------|-------------| | `--sys` | Use system cache instead of main cache | | `--writable` | Allow write operations (required for del) | | `--json` | Output raw JSON | | `--limit <n>` | Limit results (default: 100) |

Cache Types

The project has two Redis instances:

| Cache | Flag | Env Variable | Purpose | |-------|------|--------------|---------| | **Main Cache** | (default) | `REDIS_URL` | Regular cache, cluster mode, can be lost | | **System Cache** | `--sys` | `REDIS_SYS_URL` | Persistent system values, single node |

Main Cache (default)

Regular application cache. Data here can be regenerated if lost.

• User sessions
• Cached queries
• Temporary data
• Rate limiting counters

System Cache (--sys)

Persistent system configuration and state. More critical data.

• Feature flags
• Generation limits/status
• System permissions
• Job state
• Event configurations

Examples

# Find keys matching a pattern
node .claude/skills/redis-inspect/query.mjs keys "user:*" --limit 20
node .claude/skills/redis-inspect/query.mjs keys "packed:caches:*"

# Get a value
node .claude/skills/redis-inspect/query.mjs get "session:data2:123456"

# Check system cache values
node .claude/skills/redis-inspect/query.mjs --sys get "system:features"
node .claude/skills/redis-inspect/query.mjs --sys hgetall "system:entity-moderation"

# Check TTL
node .claude/skills/redis-inspect/query.mjs ttl "generation:count:123"

# Inspect a hash
node .claude/skills/redis-inspect/query.mjs hgetall "packed:caches:cosmetics"
node .claude/skills/redis-inspect/query.mjs hget "system:entity-moderation" "entities"

# Check set size
node .claude/skills/redis-inspect/query.mjs scard "queues:seen-images"

# Get server info
node .claude/skills/redis-inspect/query.mjs info
node .claude/skills/redis-inspect/query.mjs --sys info

Common Key Patterns

Main Cache

| Pattern | Description | |---------|-------------| | `user:*` | User data | | `session:*` | Session data | | `packed:caches:*` | Packed/compressed cached data | | `packed:user:*` | Packed user cache | | `generation:*` | Generation-related cache | | `tag:*` | Tag cache |

System Cache

| Pattern | Description | |---------|-------------| | `system:*` | System configuration | | `generation:*` | Generation limits/status | | `download:limits` | Download limits | | `job:*` | Job state | | `event:*` | Event configurations | | `new-order:*` | New Order game state | | `daily-challenge:*` | Daily challenge config |

Debugging Tips

# Check if a user's session exists
node .claude/skills/redis-inspect/query.mjs keys "session:data2:*" --limit 10

# Check generation status
node .claude/skills/redis-inspect/query.mjs --sys get "generation:status"

# Check feature flags
node .claude/skills/redis-inspect/query.mjs --sys hgetall "system:features"

# Check cache memory usage
node .claude/skills/redis-inspect/query.mjs info

Write Operations

Write operations require `--writable` flag and user approval:

# Delete a specific key (requires approval)
node .claude/skills/redis-inspect/query.mjs del "some:key" --writable

**IMPORTANT**: Always ask the user for permission before using `--writable`.