observe_stream
Launch a long-running command and immediately receive a window ID for live log or event-stream monitoring, then read output by cursor without consuming it.
Instructions
直接启动一条持续输出命令并打开本地滚动观察窗,立即返回 window_id(不等待命令结束)。适用于实时盯日志或持续监控输出(如 tail -f、事件流),配合 read_stream 按游标非破坏回看/翻页/续读,完成后用 close_stream 关闭并回收远端流进程。若需后台起停服务、等待就绪标记并核实进程退出码,请改用 spawn_and_observe + stop_and_verify。
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": {
"command": "<command>"
},
"name": "observe_stream"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | 窗口显示名称 | |
| layer | No | 目标层名,缺省使用默认层 | |
| stream | No | 流过滤,缺省 both | |
| command | Yes | 由本工具启动并持续观察流式输出的命令(如 'tail -f /var/log/app.log') |