redis-inspect

by @civitai in AI & LLM

6,996

712

# Install this skill:

npx skills add civitai/civitai --skill "redis-inspect"

Install specific skill from multi-skill repository

# 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.

# SKILL.md

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.

# Supported AI Coding Agents

This skill is compatible with the SKILL.md standard and works with all major AI coding agents:

⚡ Amp 🚀 Antigravity 🤖 Claude Code 🦀 Clawdbot 📝 Codex ▶️ Cursor 🤖 Droid 💎 Gemini CLI 🐙 GitHub Copilot 🪿 Goose 📊 Kilo Code 🔧 Kiro CLI 💻 OpenCode 🦘 Roo Code 🌲 Trae 🏄 Windsurf

Learn more about the SKILL.md standard and how to use these skills with your preferred AI coding agent.