ReddRadar
Agent skill
redis-inspect
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.
Install this agent skill to your Project
npx add-skill https://github.com/civitai/civitai/tree/main/.claude/skills/redis-inspect
SKILL.md
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.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
civitai/civitai
clickhouse-query
Run ClickHouse queries for analytics, metrics analysis, and event data exploration. Use when you need to query ClickHouse directly, analyze metrics, check event tracking data, or test query performance. Read-only by default.
civitai/civitai
quick-mockups
Create multiple UI design mockups in parallel. Use when asked to create mockups, wireframes, or design variations for a feature. Creates HTML files using Mantine v7 + Tailwind following Civitai's design system.
civitai/civitai
flipt
Manage Flipt feature flags - list, create, enable/disable, and configure rollout rules. Use when you need to control feature flag state or set up segmented rollouts.
civitai/civitai
bitdex-test
civitai/civitai
metabase
Create and manage Metabase questions, dashboards, and public links. Use when the user wants to build metrics dashboards, create saved questions with SQL queries, or share analytics publicly.
civitai/civitai
agent-review
Get external agent review and feedback. Routes Anthropic models through Claude Agent SDK (uses local subscription) and other models through OpenRouter API. Use for code review, architecture feedback, or any external consultation.
Didn't find tool you were looking for?