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.