Skip to content
Back to search

redis-js

HTTP based Redis Client for Serverless and Edge Functions

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/upstash/redis-js with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/upstash/redis-js'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/upstash-redis-js/badge.svg)](/listings/upstash-redis-js)

HTML

<a href="/listings/upstash-redis-js"><img src="/api/listings/upstash-redis-js/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Install

Node.js

npm install @upstash/redis

Deno

import { Redis } from "https://esm.sh/@upstash/redis";

Create database

Create a new redis database on [upstash](https://console.upstash.com/)

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 175 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Upstash Redis
  2. `@upstash/redis` is an HTTP/REST based Redis client for typescript, built on top
  3. of [Upstash REST API](https://docs.upstash.com/features/restapi).
  4. [![Tests](https://github.com/upstash/upstash-redis/actions/workflows/tests.yaml/badge.svg)](https://github.com/upstash/upstash-redis/actions/workflows/tests.yaml)
  5. ![npm (scoped)](https://img.shields.io/npm/v/@upstash/redis)
  6. ![npm bundle size](https://img.shields.io/bundlephobia/minzip/@upstash/redis)
  7. > [!NOTE]
  8. > **This project is in GA Stage.**
  9. >
  10. > The Upstash Professional Support fully covers this project. It receives regular updates, and bug fixes. The Upstash team is committed to maintaining and improving its functionality.
  11. It is the only connectionless (HTTP based) Redis client and designed for:
  12. - Serverless functions (AWS Lambda ...)
  13. - Cloudflare Workers (see
  14. [the example](https://github.com/upstash/upstash-redis/tree/main/examples/cloudflare-workers))
  15. - Fastly Compute@Edge (see
  16. [the example](https://github.com/upstash/upstash-redis/tree/main/examples/fastly))
  17. - Next.js, Jamstack ...
  18. - Client side web/mobile applications
  19. - WebAssembly
  20. - and other environments where HTTP is preferred over TCP.
  21. See
  22. [the list of APIs](https://upstash.com/docs/redis/overall/rediscompatibility)
  23. supported.
  24. > [!TIP]
  25. > **Need a Redis database fast?** Skip the signup and dashboard — POST to [`https://upstash.com/start-redis`](https://upstash.com/start-redis) to get an endpoint and token in a single HTTP request. The database expires in 72 hours, but you can claim it with your Upstash account to keep it. Especially useful for AI agents that need scratch storage on the fly.
  26. ## Quick Start
  27. ### Install
  28. #### Node.js
  29. ```bash
  30. npm install @upstash/redis
  31. ```
  32. #### Deno
  33. ```ts
  34. import { Redis } from "https://esm.sh/@upstash/redis";
  35. ```
  36. ### Create database
  37. Create a new redis database on [upstash](https://console.upstash.com/)
  38. ## Basic Usage:
  39. ```ts
  40. import { Redis } from "@upstash/redis"
  41. const redis = new Redis({
  42. url: <UPSTASH_REDIS_REST_URL>,
  43. token: <UPSTASH_REDIS_REST_TOKEN>,
  44. })
  45. // string
  46. await redis.set('key', 'value');
  47. let data = await redis.get('key');
  48. console.log(data)
  49. await redis.set('key3', 'value3', {ex: 1});
  50. // sorted set
  51. await redis.zadd('scores', { score: 1, member: 'team1' })
  52. data = await redis.zrange('scores', 0, 100 )
  53. console.log(data)
  54. // list
  55. await redis.lpush('elements', 'magnesium')
  56. data = await redis.lrange('elements', 0, 100 )
  57. console.log(data)
  58. // hash
  59. await redis.hset('people', {name: 'joe'})
  60. data = await redis.hget('people', 'name' )
  61. console.log(data)
  62. // sets
  63. await redis.sadd('animals', 'cat')
  64. data = await redis.spop('animals', 1)
  65. console.log(data)
  66. ```
  67. ## Troubleshooting
  68. We have a
  69. [dedicated page](https://docs.upstash.com/redis/sdks/javascriptsdk/troubleshooting)
  70. for common problems. If you can't find a solution, please
  71. [open an issue](https://github.com/upstash/upstash-redis/issues/new).
  72. ## Docs
  73. See [the documentation](https://upstash.com/docs/redis/sdks/ts/overview) for
  74. details.
  75. ## Resources
  76. - [Examples](https://github.com/upstash/redis-js/tree/main/examples) — runnable usage examples across runtimes and frameworks
  77. - [xadd](https://www.xadd.dev/) — engineering blog about Redis
  78. - [Search Upstash Redis docs with AI](https://context7.com/websites/upstash_redis) — query the docs via Context7
  79. ## Release Workflow
  80. ### Stable Release
  81. 1. Create a changeset (`pnpm changeset`) describing your changes and merge it to `main`
  82. 2. **Changeset** workflow runs on push to `main`. If changesets are pending, it opens a "Version Packages" PR. When that PR is merged, the workflow runs again, publishes git tags, creates GitHub releases, and uploads a `release-meta` artifact
  83. 3. **Router** workflow detects the Changeset completion via `workflow_run`, downloads the `release-meta` artifact, and calls the **npm Publish** workflow with `prerelease: false` and the resolved version
  84. 4. **npm Publish** checks out the released commit, builds, and publishes to npm under the `latest` tag
  85. ### Canary Release
  86. 1. Trigger the **Canary Release** workflow manually from the Actions tab, selecting the package
  87. 2. It creates a snapshot version (`x.y.z-canary.{timestamp}`), creates a GitHub prerelease, and uploads a `release-meta` artifact
  88. 3. **Router** picks it up the same way, calling **npm Publish** with `prerelease: true`
  89. 4. **npm Publish** publishes to npm under the `canary` tag
  90. ### CI Tests
  91. On every pull request, push to `main`, and daily schedule, the **Router** workflow runs the **Tests** workflow (unit tests, lint, build, and example integration tests).
  92. ## Contributing
  93. ### [Install Bun](https://bun.sh/docs/installation)
  94. ### Database
  95. Create a new redis database on [upstash](https://console.upstash.com/) and copy
  96. the url and token
  97. ### Running tests
  98. ```sh
  99. bun run test
  100. ```
  101. ### Building
  102. ```sh
  103. bun run build
  104. ```
  105. ### Telemetry
  106. This library sends anonymous telemetry data to help us improve your experience.
  107. We collect the following:
  108. - SDK version
  109. - Platform (Deno, Cloudflare, Vercel)
  110. - Runtime version (node@18.x)
  111. - Retry count of retried requests (to measure retry rates)
  112. You can opt out by setting the `UPSTASH_DISABLE_TELEMETRY` environment variable
  113. to any truthy value.
  114. ```sh
  115. UPSTASH_DISABLE_TELEMETRY=1
  116. ```
  117. Alternatively, you can pass `enableTelemetry: false` when initializing the Redis client:
  118. ```ts
  119. const redis = new Redis({
  120. // ...,
  121. enableTelemetry: false,
  122. });
  123. ```

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.