Skip to main content
This page covers how to execute WarpGrep’s tools (grep, read, list directory, glob) in a remote sandbox instead of locally. If you haven’t set up WarpGrep as a tool yet, start with the Agent Tool guide first.

Remote Commands

The simplest way to run WarpGrep in a sandbox. Provide functions that execute commands remotely and return raw stdout — the SDK handles all parsing.
Each function receives decomposed arguments from the model’s tool call and should return raw stdout as a string. The SDK parses and formats the output internally:

Custom Providers

The remoteCommands example above is itself a custom provider — a set of tool implementations (grep, read, list directory, glob) that override WarpGrep’s defaults. You might need a custom provider if you’re running on a non-standard operating system, a non-standard file system, or any environment where the built-in tools don’t work. Below are examples of custom providers for common sandbox providers

Platform Examples

See complete, runnable examples for each platform: