valkey

name	valkey
description	Use when building apps against Valkey - caching, sessions, queues, locks, rate-limiting, leaderboards, counters, pub/sub, streams, scripting, search, cluster, replication, HA, persistence, security. Not for server internals (valkey-dev) or ops (valkey-ops).

Reference files live under references/. Use this file as the router: open the smallest file that matches the user's task, then open adjacent files only when the task crosses a boundary.

Feature / Version Routing

User task	Open
Version availability, "what changed in Valkey 8/9", Redis compatibility, module gap	references/valkey-features.md
CAS, SET IFEQ, DELIFEQ, conditional delete/update, Lua replacement for compare-and-set/delete	references/conditional-writes.md
Hash-field TTL, HSETEX, HGETEX, HEXPIRE, HTTL, per-field expiry return codes	references/hash-field-ttl.md
COMMANDLOG, SLOWLOG compatibility, slow command / large request / large reply lookup	references/commandlog.md
Polygon geo queries, GEOSEARCH BYPOLYGON, antimeridian caveats	references/geosearch-bypolygon.md
Redis OSS/CE migration, extended-redis-compatibility, RDB magic, client identity, module availability	references/redis-compatibility.md

Application Workflow Routing

User task	Open
Application workflow router / task-boundary overview	references/app-patterns.md
Cache-aside, stampede prevention, early refresh, TTL jitter, explicit invalidation, cache eviction choices	references/app-caching.md
Server-assisted client-side caching, CLIENT TRACKING, RESP3 push, RESP2 REDIRECT, BCAST/OPTIN/OPTOUT	references/app-client-side-caching.md
Sessions, sliding TTL, session rotation, per-field session TTL, concurrent session tracking	references/app-sessions.md
Distributed locks, safe lock release, renewal, Redlock, fencing tokens, pre-version Lua fallback	references/app-locks.md plus references/conditional-writes.md for command semantics
Rate limiting, fixed/sliding windows, token bucket, per-field TTL rate counters	references/app-rate-limiting.md
Queues, streams, consumer groups, pending/reclaim, trimming, dead-letter queues, priority queues	references/app-queues.md
Counters, idempotency, approximate counting, dedup, HyperLogLog, BITFIELD, Bloom filters	references/app-counters-dedup.md
Leaderboards and rankings	references/app-leaderboards.md
Pub/Sub, sharded pub/sub, keyspace notifications, PUBSUB introspection	references/app-pubsub.md
Search, autocomplete, tag filtering, valkey-search	references/app-search.md

Cluster / HA Routing

User task	Open
Cluster / HA router / task-boundary overview	references/cluster-and-ha.md
Hash slots, hash tags, CROSSSLOT, MOVED/ASK, cluster clients, read replicas, per-primary SCAN, sharded pub/sub, numbered DBs	references/cluster-key-client-behavior.md
Slot migration, resharding, CLUSTER MIGRATESLOTS, GETSLOTMIGRATIONS, no-ASK-window behavior	references/cluster-slot-migration.md
Replication, full/partial resync, backlog sizing, diskless replication, dual-channel, MPTCP, Sentinel failover, retry/idempotency rules	references/replication-sentinel-retries.md
Durability, WAIT, WAITAOF, AOF/RDB persistence, fork pauses, copy-on-write, cache-vs-source-of-truth	references/durability-persistence.md

Performance Routing

Diagnosis area	Open
Performance router / diagnosis-boundary overview	references/performance.md
Memory encoding, key sizing, compact encodings, top-level overhead, OBJECT introspection, bitmaps, large values	references/performance-memory-encoding.md
TTL, eviction policy, maxmemory, LFU/LRU choices, big-key drain before UNLINK	references/performance-eviction-ttl.md
Fragmentation, active defrag, MEMORY DOCTOR, allocator ratios	references/performance-fragmentation.md
Latency, intrinsic latency, LATENCY monitor, COMMANDLOG, fork/expiration/AOF/swap signals	references/performance-latency.md
Throughput, pipelining, connection pooling, I/O threads, hot-key mitigation	references/performance-throughput.md
Benchmarking, valkey-benchmark, memtier_benchmark, pipeline/client-thread pitfalls	references/performance-benchmarking.md

Other Focused References

User task	Open
Lua, EVAL/EVALSHA, FUNCTIONs, script determinism, server.call/pcall, KILL behavior	references/scripting.md
AUTH, ACLs, ACL categories, key/channel permissions, TLS	references/security.md
Production anti-patterns, quick corrections, detection commands, fix matrix	references/anti-patterns.md