shell_send
Sends text to an interactive program.
Only works for sessions started with interactive true. Goes through the same scan.
- Tool name
- shell_send
- Group
- Shell
- Risk
- medium
- Needs approval
- sometimes
- Approval rule
- Text is scanned like a command.
- Allowed in scheduled jobs
- No
- Default
- off
Parameters
| Name | Type | Required | Default | Meaning | Limits |
|---|---|---|---|---|---|
| session | string | No | main | Name of a persistent shell session. | |
| text | string | Yes | Text to type or say. | ||
| enter | boolean | No | true | Press Enter after the text. | |
| eof | boolean | No | false | Send end-of-input. |
Returns
Output after the input.
Example (made up for this page)
{
"text": "demo"
}Sent 1 line.Side effects
- Sends input to a running process.
How it can fail
| When | What the agent sees |
|---|---|
| No interactive program | An error text |
See also:Shell tools
Checked against the source at commit f4fd89f on 29 Oct 2026. Everything here is merged on the main branch; no release has been tagged yet. The source is private, so these pages are the public description.