Ravi Secrets
Store and retrieve key-value secrets (API keys, environment variables, tokens). All values are server-side encrypted — you send and receive plaintext. Keys are stored in plaintext for lookup/filtering.
Commands
CODEBLOCK0
JSON Shapes
ravi secrets list:
CODEBLOCK1
ravi secrets get OPENAI_API_KEY:
CODEBLOCK2
Common Patterns
Store and retrieve API keys at runtime
CODEBLOCK3
Store multiple service keys
CODEBLOCK4
Important Notes
- - Server-side encryption is transparent — you always see plaintext values.
- Keys must be unique per identity — if you need to update an existing key, use
ravi secrets set again (it will upsert). Creating a duplicate key name will return a validation error. - Keys are auto-uppercased — keys are automatically uppercased by the server (e.g.
test_key becomes TEST_KEY). Keys must match ^[A-Z][A-Z0-9_]*$ after uppercasing. - Keys are plaintext — only values and notes are encrypted. Use descriptive key names like
OPENAI_API_KEY, STRIPE_SECRET_KEY.
Full API Reference
For complete endpoint details, request/response schemas, and parameters: Secrets
Related Skills
- - ravi-passwords — Store website credentials (domain + username + password, not key-value secrets)
- ravi-login — Signup workflows that may need API keys stored after registration
- ravi-feedback — Report secrets issues or suggest improvements
Ravi Secrets
存储和检索键值对形式的机密信息(API密钥、环境变量、令牌)。所有值均经过服务器端加密——你发送和接收的都是明文。密钥以明文形式存储,便于查找和筛选。
命令
bash
存储一个机密
ravi secrets set OPENAI
APIKEY sk-abc123...
列出所有机密
ravi secrets list
根据密钥名称检索机密
ravi secrets get OPENAI
APIKEY
根据UUID删除机密
ravi secrets delete
JSON格式
ravi secrets list:
json
[
{
uuid: ...,
identity: 1,
key: OPENAIAPIKEY,
value: sk-abc123...,
notes: ,
created_dt: 2026-02-25T10:30:00Z,
updated_dt: 2026-02-25T10:30:00Z
}
]
ravi secrets get OPENAIAPIKEY:
json
{
uuid: ...,
identity: 1,
key: OPENAIAPIKEY,
value: sk-abc123...,
notes: ,
created_dt: 2026-02-25T10:30:00Z,
updated_dt: 2026-02-25T10:30:00Z
}
常见模式
在运行时存储和检索API密钥
bash
存储一个密钥
ravi secrets set OPENAIAPIKEY sk-abc123...
检索密钥值
APIKEY=$(ravi secrets get OPENAIAPI_KEY | jq -r .value)
列出所有可用的密钥名称
ravi secrets list | jq -r .[].key
存储多个服务密钥
bash
ravi secrets set ANTHROPICAPIKEY sk-ant-...
ravi secrets set GITHUBTOKEN ghp...
重要说明
- - 服务器端加密是透明的——你始终看到的是明文值。
- 每个身份下的密钥必须唯一——如果需要更新现有密钥,请再次使用 ravi secrets set(它会执行更新插入操作)。创建重复的密钥名称将返回验证错误。
- 密钥会自动转为大写——服务器会自动将密钥转为大写(例如 testkey 会变成 TESTKEY)。转为大写后,密钥必须符合 ^[A-Z][A-Z0-9]*$ 格式。
- 密钥以明文形式存储——只有值和备注会被加密。请使用描述性的密钥名称,如 OPENAIAPIKEY、STRIPESECRET_KEY。
完整API参考
有关完整的端点详情、请求/响应模式和参数,请参阅:Secrets
相关技能
- - ravi-passwords——存储网站凭据(域名 + 用户名 + 密码,非键值对机密)
- ravi-login——注册工作流,可能需要在注册后存储API密钥
- ravi-feedback——报告机密问题或提出改进建议