ag2-shell-tool
Installation
SKILL.md
Shell tools
When to use
Two distinct tools, both named "shell" — pick deliberately:
| Need | Use | Why |
|---|---|---|
| Works with any model provider; full control over what runs and where | SandboxShellTool |
Client-side subprocess (via LocalEnvironment). You own the sandbox. |
| Provider-managed sandbox (container, network policy) on OpenAI Responses | ShellTool |
Server-side execution. No local subprocess. |
SandboxShellTool is the workhorse. Reach for it unless you specifically need provider-managed isolation and you're on OpenAI Responses.
60-second recipe — SandboxShellTool
from ag2 import Agent
from ag2.config import AnthropicConfig
from ag2.tools import SandboxShellTool