Skill

ioredis

Provides ioredis v5 reference for Node.js Redis client: connections (standalone/cluster/sentinel), pipelines/transactions, Pub/Sub/Streams, Lua scripting, retry/TLS options, and debugging.

Redis

Node

npx claudepluginhub jgamaraalv/ts-dev-kit --plugin ts-dev-kit

Tool Access

This skill uses the workspace's default tool permissions.

Preview

ioredis v5.x. Requires Node.js >= 12, Redis >= 2.6.12. 100% TypeScript.

Supporting Assets

references/advanced-patterns.mdreferences/cluster-sentinel.mdreferences/connection-options.mdreferences/core-api.md

SKILL.md

Similar Skills

bun-redis

140

Guides Redis integration in Bun with ioredis, @upstash/redis, and official redis clients. Covers connections, strings, hashes, lists, sets, sorted sets for caching, queues, leaderboards.

bun

redis

Guides Redis system design: data structures for caching, queues, leaderboards, sessions; caching strategies, pub/sub, streams, clustering, memory optimization, Lua scripting.

godmode

redis-patterns

1.6k

Provides TypeScript patterns for Redis: cache-aside/invalidation, sliding window rate limiting, pub/sub, and consumer group streams for events.

claude-code-toolkit

Stats

Stars15

Forks0

Last CommitFeb 28, 2026

Actions

View Source View Plugin View on GitHub View README

Help us improve

Share bugs, ideas, or general feedback.

ioredis v5 — Node.js Redis Client

ioredis v5.x. Requires Node.js >= 12, Redis >= 2.6.12. 100% TypeScript.

<quick_reference>

Critical: Import Style

// CORRECT — named import (required for NodeNext / moduleResolution: "nodenext") import { Redis } from "ioredis"; // For Cluster: import { Redis, Cluster } from "ioredis";

Quick Reference

Operation

Code

Connect

new Redis() or new Redis(6379, "host") or new Redis("redis://...")

Get/Set

await redis.set("key", "val") / await redis.get("key")

Pipeline

await redis.pipeline().set("a","1").get("a").exec()

Transaction

await redis.multi().set("a","1").get("a").exec()

Pub/Sub

sub.subscribe("ch") / sub.on("message", cb) / pub.publish("ch", msg)

Lua script

redis.defineCommand("name", { numberOfKeys: 1, lua: "..." })

Scan

redis.scanStream({ match: "prefix:*", count: 100 })

Graceful close

await redis.quit()

Force close

redis.disconnect()

</quick_reference>

Common Gotchas

Named import: Always import { Redis } from "ioredis" with NodeNext resolution

Pub/Sub isolation: A subscribed client cannot run other commands — use separate instances

maxRetriesPerRequest: Default is 20. Set to null for infinite retries (required by BullMQ)

Pipeline errors: pipeline.exec() never rejects — errors are in each result's [0] position

showFriendlyErrorStack: Performance cost — never enable in production

Cluster pipelines: All keys in a pipeline must hash to slots served by the same node

enableAutoPipelining: 35-50% throughput improvement, safe to enable globally

When to Load References

Need

Reference file

Connection setup, RedisOptions, TLS, retryStrategy, lifecycle

references/connection-options.md

Core API: pipelines, transactions, Pub/Sub, Lua scripting, scanning, events

references/core-api.md

Streams, auto-pipelining, transformers, binary data, error handling, debugging

references/advanced-patterns.md

Redis Cluster setup, ClusterOptions, Sentinel config, failover

references/cluster-sentinel.md

ioredis v5 — Node.js Redis Client

ioredis v5.x. Requires Node.js >= 12, Redis >= 2.6.12. 100% TypeScript.

<quick_reference>

Critical: Import Style

// CORRECT — named import (required for NodeNext / moduleResolution: "nodenext")
import { Redis } from "ioredis";

// For Cluster:
import { Redis, Cluster } from "ioredis";

Quick Reference

Operation	Code
Connect	`new Redis()` or `new Redis(6379, "host")` or `new Redis("redis://...")`
Get/Set	`await redis.set("key", "val")` / `await redis.get("key")`
Pipeline	`await redis.pipeline().set("a","1").get("a").exec()`
Transaction	`await redis.multi().set("a","1").get("a").exec()`
Pub/Sub	`sub.subscribe("ch")` / `sub.on("message", cb)` / `pub.publish("ch", msg)`
Lua script	`redis.defineCommand("name", { numberOfKeys: 1, lua: "..." })`
Scan	`redis.scanStream({ match: "prefix:*", count: 100 })`
Graceful close	`await redis.quit()`
Force close	`redis.disconnect()`

</quick_reference>

Common Gotchas

Named import: Always import { Redis } from "ioredis" with NodeNext resolution
Pub/Sub isolation: A subscribed client cannot run other commands — use separate instances
maxRetriesPerRequest: Default is 20. Set to null for infinite retries (required by BullMQ)
Pipeline errors: pipeline.exec() never rejects — errors are in each result's [0] position
showFriendlyErrorStack: Performance cost — never enable in production
Cluster pipelines: All keys in a pipeline must hash to slots served by the same node
enableAutoPipelining: 35-50% throughput improvement, safe to enable globally

When to Load References

Need	Reference file
Connection setup, RedisOptions, TLS, retryStrategy, lifecycle	references/connection-options.md
Core API: pipelines, transactions, Pub/Sub, Lua scripting, scanning, events	references/core-api.md
Streams, auto-pipelining, transformers, binary data, error handling, debugging	references/advanced-patterns.md
Redis Cluster setup, ClusterOptions, Sentinel config, failover	references/cluster-sentinel.md