--- 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 ```bash node .claude\/skills\/redis-inspect\/query.mjs [options] ``` ### Commands | Command | Description | |---------|-------------| | `get ` | Get a string value | | `keys ` | Find keys matching pattern (use * as wildcard) | | `ttl ` | Get TTL (-1 = no expiry, -2 = not found) | | `type ` | Get the type of a key | | `exists ` | Check if key exists | | `hgetall ` | Get all fields from a hash | | `hget ` | Get a specific hash field | | `scard ` | Get set cardinality (count) | | `smembers ` | Get all set members | | `llen ` | Get list length | | `lrange ` | Get list elements | | `del ` | 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 ` | 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 ```bash # 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 ```bash # 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: ```bash # 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`.