---
title: "ShellServerToolConfig"
---

Configuration for the openrouter:shell server tool


## Fields

| Field                                                                                                                                                                                                                                            | Type                                                                                                                                                                                                                                             | Required                                                                                                                                                                                                                                         | Description                                                                                                                                                                                                                                      | Example                                                                                                                                                                                                                                          |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `engine`                                                                                                                                                                                                                                         | [Optional[components.ShellServerToolEngine]](../components/shellservertoolengine.mdx)                                                                                                                                                             | :heavy_minus_sign:                                                                                                                                                                                                                               | Which shell engine to use. "openrouter" runs commands server-side in the OpenRouter sandbox. "auto" (default) keeps the provider's native hosted shell when available (OpenAI); on other providers the call is routed to the OpenRouter sandbox. | openrouter                                                                                                                                                                                                                                       |
| `environment`                                                                                                                                                                                                                                    | [Optional[components.ShellServerToolEnvironment]](../components/shellservertoolenvironment.mdx)                                                                                                                                                   | :heavy_minus_sign:                                                                                                                                                                                                                               | Server-side execution environment for the shell tool. Only container-backed environments are supported; "local" shells are not.                                                                                                                  | \{<br/>"type": "container_auto"<br/>}                                                                                                                                                                                                             |
| `sleep_after_seconds`                                                                                                                                                                                                                            | *Optional[int]*                                                                                                                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                                                                                               | How long (in seconds) the container stays warm after its last command before sleeping, freeing its capacity slot. Idle-based: each command renews the timer. Defaults to 900 (15 minutes); capped at 2592000 (30 days).                          | 900                                                                                                                                                                                                                                              |