civitai / redis-inspect
Install for your project team
Run this command in your project directory to install the skill for your entire team:
mkdir -p .claude/skills/redis-inspect && curl -L -o skill.zip "https://fastmcp.me/Skills/Download/873" && unzip -o skill.zip -d .claude/skills/redis-inspect && rm skill.zipProject Skills
This skill will be saved in .claude/skills/redis-inspect/ and checked into git. All team members will have access to it automatically.
Important: Please verify the skill by reviewing its instructions before using it.
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.
6 views
0 installs
Skill Content
--- 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 <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 ```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`.