vault_save_secret
Save an existing secret into the owner's vault by pointing to its file or command, without exposing the value in chat; it waits for owner approval and returns only name, source, and length.
Instructions
Save a secret you ALREADY HAVE into the owner's vault, without reading it into this chat: point at the file it is in, or the command that prints it, and the helper takes the value from there. It waits for the owner, marked "saved by an agent"; no agent can use it until the owner saves it with their passkey and sets it up, so tell the owner it is waiting under Needs you. You get back the name, where it came from and its length, never the value.
Give exactly one of: from_file (an absolute path; read as your own user, up to 64 KB); from_command (a list: the program, then its arguments; no shell, 30 seconds, only what it prints on standard output; a failing command saves nothing); value (the text itself, only when it is already in this chat). With a file or command, pick takes one part: {env:"NAME"} for a NAME=value line (.env files), or {json:"a.b"} for a field of JSON. Otherwise the whole text is the value, less one final newline. Never cat or echo a secret to find it: use this tool.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"save_as": "<save_as>",
"purpose": "<purpose>"
},
"name": "vault_save_secret"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pick | No | Optional, with from_file or from_command: {env:"NAME"} or {json:"a.b.c"}. | |
| value | No | The secret itself, only if it is already in this chat. | |
| purpose | Yes | Why it should be in the vault (shown to the owner). | |
| save_as | Yes | Name for the secret in the vault, 1 to 80 characters. | |
| service | No | Optional: the service it is for (e.g. "resend"), shown to the owner as a hint. | |
| from_file | No | Absolute path of the file holding the secret. | |
| from_command | No | The program and its arguments, e.g. ["gh","auth","token"]. No shell. |