# shell_tool

> **Function** in `langchain`

📖 [View in docs](https://reference.langchain.com/python/langchain/agents/middleware/shell_tool/ShellToolMiddleware/__init__/shell_tool)

## Signature

```python
shell_tool(
    *,
    runtime: ToolRuntime[None, ShellToolState],
    command: str | None = None,
    restart: bool = False,
) -> ToolMessage | str
```

---

[View source on GitHub](https://github.com/langchain-ai/langchain/blob/be854a130153e51346d83d3b06f959b80f6cbca6/libs/langchain_v1/langchain/agents/middleware/shell_tool.py#L605)