ravi-secrets

Store and retrieve encrypted key-value secrets via the Ravi CLI.

1|Updated Feb 27, 2026
One-click install
npx skills add https://github.com/ravi-hq/ravi-skills --skill ravi-secrets-ravi-hq
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ravi-secrets
Source: https://github.com/ravi-hq/ravi-skills/tree/main/skills/ravi-secrets
Command: npx skills add https://github.com/ravi-hq/ravi-skills --skill ravi-secrets-ravi-hq

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? AI agents need a secure place to keep API keys, tokens, and environment variables they create or receive while working, without hardcoding them or losing them between sessions. ## Core Features & Use Cases - Encrypted Secret Storage: Store key-value secrets with automatic encryption of values and notes. - Lookup and Management: List, retrieve by key name, and delete secrets by UUID through simple CLI commands. - Use Case: An agent signs up for a third-party API, receives an API key, and stores it with ravi secrets set OPENAI_API_KEY "sk-..." so it can retrieve the key in later sessions with ravi secrets get OPENAI_API_KEY. ## Quick Start Ask the agent to store an API key as an encrypted secret and then retrieve its value by key name using the Ravi CLI.

Frequently Asked Questions about ravi-secrets

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I store an API key as an encrypted secret with the Ravi CLI?▼

Run ravi secrets set KEY_NAME "value" to store an encrypted secret. Keys are auto-uppercased and must match the pattern ^[A-Z][A-Z0-9_]*$, and calling set again on an existing key upserts the value.

How do I retrieve a secret value in a shell script?▼

Use ravi secrets get KEY_NAME, which returns a JSON object containing the value field. Pipe it through jq, for example API_KEY=$(ravi secrets get OPENAI_API_KEY | jq -r '.value'), to extract just the secret value.

What is the difference between ravi-secrets and ravi-passwords?▼

ravi-secrets stores key-value secrets like API keys and environment variables, while ravi-passwords stores website credentials structured as domain, username, and password. Use ravi-passwords for login credentials and ravi-secrets for tokens and keys.

Why does creating a secret fail with a validation error?▼

Secret keys must be unique per identity and match the pattern ^[A-Z][A-Z0-9_]*$ after automatic uppercasing. A duplicate key name or invalid characters in the key will return a validation error.

Do I need to authenticate before using ravi secrets commands?▼

Yes, the Ravi CLI must be installed and authenticated with ravi auth login, which a human approves at https://ravi.id/device. The CLI stores keys in ~/.ravi/config.json and reads them automatically for subsequent commands.