shell_view
Shows new output of a shell session.
Shows new output of a shell session.
- Tool name
- shell_view
- Group
- Shell
- Risk
- none
- Needs approval
- never
- Approval rule
- Read only.
- Allowed in scheduled jobs
- No
- Default
- off
Parameters
| Name | Type | Required | Default | Meaning | Limits |
|---|---|---|---|---|---|
| session | string | No | main | Name of a persistent shell session. | |
| wait | number | No | 0 | Seconds to wait for output before returning. | |
| lines | integer | No | 60 | How many output lines to show. | |
| tail | boolean | No | false | Show the last lines instead of the first. |
Returns
Output lines and status.
Example (made up for this page)
{}(running) 3 linesSide effects
- none
How it can fail
| When | What the agent sees |
|---|---|
| Shell is off | Shell disabled message |
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.