vars
Store variables server-side to persist across calls, so commands, paths, URLs, and headers can reference them by name without re-sending data.
Instructions
Server-side variables that persist between calls, so a value never has to be re-sent through the conversation. Store once, then reference it as ${vars.} in later calls — in a command, cwd, env, a path, a URL, a header, a git message, a bulk step. list shows names, types and sizes but NOT full values (that is the saving). Mark a token secret:true and it stays usable via ${vars.…} while never being echoed back. shell_bulk assign, shell_exec assign and http_request assign all write here.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| json | No | load: parse the file as JSON instead of storing it as text. | |
| name | No | Variable name. Letters, digits, _ . - starting with a letter or _. | |
| path | No | load: file to read into the variable. save: file to write the variable to. | |
| text | No | append: the text (or array element) to add. | |
| delta | No | incr: how much to add. Default 1. | |
| names | No | get/delete: act on several names at once. | |
| value | No | set: the value — any JSON type. A string is itself ${...}-expanded, so you can compose from other variables. | |
| action | Yes | set | get | list | delete | clear | append (to a string/array) | incr (numeric) | load (read a file into a variable) | save (write a variable to a file). | |
| reveal | No | get: return a secret value in plain text. Only when you actually need to read it. | |
| secret | No | set/load: never echo this value back in get or list. It still works in ${vars.…}. | |
| ttl_ms | No | set: forget the variable after this long. | |
| confirm | No | clear: required, since it drops every variable. | |
| max_bytes | No | get: byte cap on the returned value. |