remote_exec
Execute shell commands on a user-owned remote host over HTTPS. Requires prior configuration of host and authorized command allowlist.
Instructions
Execute a shell command on a user-owned remote host (VPS, NAS, home server) over HTTPS. Requires a remote_hosts entry in partner_tools that lists the host and an auth token. If no remote_hosts entry exists for the calling Being, this tool returns an invalid_request error — the user must configure partner_tools.remote_hosts first. The remote receiver enforces a default-deny allowlist; unauthorised commands return a forbidden error. Token values are never returned to the caller.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| host | Yes | host_id from the remote_hosts entry in partner_tools. | |
| stdin | No | Standard input piped to the command. Default empty. | |
| command | Yes | Full command string. Must be authorised by the receiver's allowlist. | |
| timeout_ms | No | Per-call timeout in milliseconds. Receivers may enforce their own upper bound. |