Manage secrets
secretStore, inspect, check expiry, and delete non-GitHub tokens without exposing values; retrieve metadata only and inject stored credentials into shell commands through environment variables.
Instructions
Store and inspect tokens without exposing them (AES-256-GCM at rest). action: set | get (metadata only) | list | delete. Inject into commands with shell_run secret_env=[NAME]; the GitHub tools read GITHUB_TOKEN on their own. Use when: you save a non-GitHub token, check expiry or rotation, or remove one. Prefer value_env over value so the secret never appears in chat. Avoid when: the value is plain config (use .env or the config file). reveal=true prints plaintext and needs VENIRA_SHELL_MODE=permissive or off. Output: set: name, length, expires_at, days_left. get and list: metadata only.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "secret"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Env-var style name, e.g. GITHUB_TOKEN (required for get/set/delete). | |
| value | No | Secret value for action=set. Prefer value_env so it never appears in the transcript. | |
| action | No | set stores a secret; get returns metadata only (plaintext needs reveal=true); list shows all stored secrets; delete removes one. | list |
| reason | No | Optional why (max 400 chars), audit-logged. | |
| reveal | No | action=get: 1 prints plaintext; needs VENIRA_SHELL_MODE=permissive or off; prefer secret_env injection. | |
| value_env | No | Read the value from this host environment variable instead of `value` (never logged). | |
| expires_at | No | action=set: absolute expiry (epoch ms or ISO-8601), instead of expires_in_days. | |
| expires_in_days | No | action=set: expiry in days (e.g. 90 for quarterly rotation). Expired secrets are not injected. |