upload
Copy a local project file to a remote workspace, replacing the remote copy while excluding secrets and project state; on guarded fleets, confirm only after explicit user agreement.
Instructions
Copy one file from the LOCAL project directory to the remote workspace (up to 64 MiB). Replaces an existing remote file. Secrets and project state (.git, .claude, .env*, keys, .mirafleet.yaml) are never transferred. On a guarded fleet you must first ask the user and get their explicit agreement; only then set confirm to the fleet name.
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": {
"local": "<local>"
},
"name": "upload"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | Permission bits (decimal). Default: keep the executable bit. | |
| fleet | No | Fleet name. Omit to use the default. | |
| local | Yes | Local file, relative to the local project directory (or absolute inside it). Secrets and project state (.git, .env*, keys, .mirafleet.yaml) are refused. | |
| remote | No | Destination on the remote machine. Default: the same relative path as local. | |
| confirm | No | Guarded fleets only: the fleet name, set only after the user explicitly agreed. Never set it on your own. | |
| context | No | Context name. Omit to use the default. | |
| workspace | No | Workspace id. Omit to use this session's workspace on the fleet. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bytes | Yes | ||
| local | Yes | ||
| where | Yes | ||
| remote | Yes | ||
| workspace | Yes |