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 .