env_promote
Convert an environment's current state into a durable golden image for future forks. The environment is shut down, copied as a full disk, and left intact for later removal if no longer needed.
Instructions
Flatten an environment's current state into a new golden image that env_fork can use, so a machine configured during this session becomes a reusable fork source. A full disk copy: takes minutes and the disk of a golden, and afterwards depends on nothing. The environment is shut down first and left in place; remove it with env_rm if it is no longer needed once promoted. Promote only when the user wants the machine kept: the result is durable and only the user can remove it.
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": {
"name": "<name>",
"image": "<image>"
},
"name": "env_promote"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | env whose current state becomes the golden | |
| image | Yes | name for the new golden image: letters, digits, dots, dashes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| log | No | ||
| golden | Yes |