# 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/fb6ab993a73180538f6cca876b3c85d46c08845f/libs/langchain_v1/langchain/agents/middleware/shell_tool.py#L576)