1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | upstash-cli-upstash-skills |
| 作者/维护者 | Upstash(Serverless Redis / Vector / QStash 等服务的所有者) |
| 来源链接 | https://github.com/upstash/skills/tree/main/skills/upstash-cli |
| 许可证 | MIT |
| GitHub Stars / Forks | 31 / 7(属 upstash/skills 整个仓库,非本技能独有;GitHub API) |
| 配套 CLI | upstash npm 包 v1.5.0(2026-10-06 发布,MIT;npm API);upstash/cli 仓库 31 stars,近一月 npm 下载约 3,000(GitHub API / npm API) |
| 技能安装量 | skills.sh 显示约 1,400 次安装 |
| 最近更新 | 本技能目录最近修改于 2026-10-06(GitHub API) |
| 安装方式 | npx skills add https://github.com/upstash/skills --skill upstash-cli,或 npx upstash setup 装 Upstash 插件 |
2. 功能介绍与亮点
让 agent 在终端、脚本或 CI 里用 upstash 命令行管理 Upstash 账号下的云资源。
- 覆盖面:Redis、Vector、Search、QStash、Blob 的创建、重命名、删除、重置密码、改套餐/区域/TLS/淘汰策略/预算、备份与恢复、用量统计,以及团队与成员管理
- Blob 临时凭证:
blob credentials换取限定到单个桶的临时 S3 凭证,供 AWS CLI / rclone 使用 - 自动化友好:输出 JSON,可管道给
jq;删除类命令支持--dry-run;redis get/blob get支持--hide-credentials - 一键接入:
upstash setup --yes --claude等为 Claude Code、Codex、Cursor、Gemini CLI 装插件,为 VS Code、Copilot CLI、OpenCode 配远程 MCP - 路由约定:会话里已有 Upstash MCP 工具时优先用 MCP,仅在 CI、批量脚本、登录和密钥设置等 shell 场景加载本技能
3. 适用场景
所属分类:DevOps 与基础设施。
- 在 CI 或开通脚本里批量创建 / 清理 Upstash 数据库、索引、队列
- 用只读 API Key 让 agent 查询用量和库列表
- 为 Blob 桶生成限时 S3 凭证做数据迁移
- 管理团队成员、套餐与预算
适合已在使用 Upstash 并习惯命令行的开发者和运维。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 标准 SKILL.md;upstash setup --claude 可直接装插件 |
| Codex | 原生支持 | 同上,--codex 为官方支持的目标;Codex 需手动引用技能目录 |
| OpenClaw | 未验证 | 技能本身只是 SKILL.md + 终端命令,理论上可读,未见官方说明 |
| Hermes Agent | 未验证 | 同上 |
5. 推荐理由
Upstash 的控制台操作难以脚本化,这个技能把官方 CLI 的全部子命令、区域与参数枚举、安全习惯(先 --dry-run、隐藏凭证、用只读 Key)一次告诉 agent,省去反复查文档。出自厂商本身,随 CLI 同步更新。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 厂商出品;skills.sh 约 1,400 次安装;仓库本身 31 stars,讨论零星 |
| 可用性 | 8 | npx 即可运行,文档完整含命令清单;需先创建 Developer API Key;2026-10 仍在维护 |
| 安全性 | 8 | 见下方检查清单 |
综合 7.67(三项均值)。
安全检查清单:
- ① shell 命令:只调用
upstashCLI,范围明确;包含delete、reset-password、change-plan等破坏性或涉费命令,技能反复提示先--dry-run - ② 联网:访问 Upstash API 与 mcp.upstash.com,目标透明
- ③ 凭据:Developer API Key / 邮箱,存于
~/.config/upstash/config.json或环境变量;建议用只读 Key;setup走 OAuth,不把 Key 写入 agent 配置 - ④ 无可疑指令或混淆内容
- ⑤ 作者为 Upstash 官方组织
- ⑥ MIT 许可证
- ⑦ 近期持续维护
- 第三方审计:Gen Agent Trust Hub、Socket、Snyk 均为 Pass
7. 跟同类 Skills 相比的优势
| 对象 | 定位 | 差异 |
|---|---|---|
| Upstash MCP 服务(mcp.upstash.com) | 同一厂商的远程 MCP,会话内直接调用,免 API Key | 适合交互式管理;CLI 技能补足脚本化、CI、密钥与团队管理等 shell 场景 |
| Upstash 控制台 | 网页图形界面 | 无法脚本化与批量,也不便 agent 调用 |
| 同厂商 SDK 类技能(upstash-redis-js 等) | 教 agent 写应用代码 | 管的是应用内调用,不创建或删除账号下的资源 |
| 其他云厂商 CLI 技能(如 Cloudflare wrangler、Railway) | 各自平台的部署与资源管理 | 平台不同;本技能专注 Upstash 数据与消息服务 |
8. 用户评价
- GitHub 用户 ruchernchong 在 upstash/cli 的 issue #8(2025-06)提出希望按项目或组织使用多个 API Key 配置,说明有人在多项目场景下实际使用该 CLI
- GitHub 用户 TheGreatAlgo 在 issue #6(2024-11)反馈创建数据库时 CLI 尚不支持
primary_region参数;该问题已关闭 - 该技能目前在第三方平台尚无具名的使用评价。
10. 安装使用方式
npx skills add https://github.com/upstash/skills --skill upstash-cli
npm i -g upstash # 或直接 npx upstash <command>
upstash login # 填邮箱与 Developer API Key
npx -y upstash setup --yes --claude # 可选:为 Claude Code 装插件
安装后重载插件(Claude Code:/reload-plugins)。触发方式:提到“用 Upstash CLI”“在脚本里创建 Redis”等。
11. 注意事项
- 需 Upstash 账号与 Developer API Key;部分命令会改变套餐和计费,执行前先确认
- 会话里已有 Upstash MCP 时,技能会引导优先用 MCP
- Blob 子命令依赖较新的 CLI 版本,先
upstash blob --help确认 - 技能仓库整体 stars 较少,热度主要体现在安装量上