Create a new E2B cloud sandbox (secure Linux VM). Returns a sandboxId to use with other tools.

List all active E2B sandboxes managed by this server.

Get details about a specific sandbox.

Terminate and clean up a sandbox. The sandbox and all its data will be destroyed.

Extend a sandbox timeout to prevent it from being automatically terminated.

Pause a sandbox to preserve its state. The sandbox can be resumed later with sandbox_resume using the same sandbox ID. Paused sandboxes persist across sessions and do not count against timeout.

Resume a previously paused sandbox. Reconnects to the sandbox and restores its state including filesystem and running processes.

Get the public URL for a port running inside a sandbox. Use this to access dev servers, web apps, or any HTTP service running in the sandbox from a browser.

Get a presigned URL to upload a file to the sandbox. Send a POST request with the file as multipart/form-data to the returned URL.

Get a presigned URL to download a file from the sandbox. Use this to retrieve build artifacts, logs, or any file from the sandbox.

Execute a shell command in a sandbox and return stdout, stderr, and exit code. Use for running builds, tests, installs, or any CLI command.

Start a background process in a sandbox (e.g., dev server, file watcher). Returns immediately without waiting for completion.

List all running processes (commands and PTY sessions) in a sandbox. Shows PID, command, and arguments for each process.

Kill a running process in a sandbox by its PID. Use sandbox_process_list to find the PID.

Read the contents of a file in a sandbox.

Write content to a file in a sandbox. Creates parent directories automatically. Overwrites if file exists.

List files and directories in a sandbox path.

Create a directory (and parent directories) in a sandbox.

Delete a file or directory in a sandbox.

Get metadata about a file or directory in a sandbox (size, type, permissions).

Check if a file or directory exists in a sandbox. Returns true/false without throwing an error if not found.

Rename or move a file or directory in a sandbox.

Clone a GitHub repository into a sandbox. Supports private repos when GITHUB_TOKEN is configured.

Get the git status of a repository in a sandbox (current branch, modified/staged/untracked files).

Stage files and create a git commit in a sandbox repository.

Push commits to a remote repository. Requires GITHUB_TOKEN for authentication.

Manage git branches: list, create, or switch branches in a sandbox repository.

Pull latest changes from a remote repository in a sandbox.

Initialize a new git repository in a sandbox directory.