> ## Documentation Index > Fetch the complete documentation index at: https://docs.microsandbox.dev/llms.txt > Use this file to discover all available pages before exploring further. # Execution > Rust SDK - Command execution API reference Run commands inside a running sandbox: buffer the output in one call, stream it event by event, drive a shell, or bridge your terminal to an interactive PTY session. See [Commands](/sandboxes/commands) for usage examples.

Typical flow

```rust theme={null} use microsandbox::Sandbox; let sb = Sandbox::builder("api").image("python").create().await?; // Buffered: run and collect everything let out = sb.exec("python", ["-c", "print('hi')"]).await?; println!("{}", out.stdout()?); // Streaming: process output as it arrives let mut handle = sb.exec_stream("tail", ["-f", "/var/log/app.log"]).await?; while let Some(event) = handle.recv().await { if let microsandbox::ExecEvent::Stdout(chunk) = event { print!("{}", String::from_utf8_lossy(&chunk)); } } sb.stop().await?; ``` ## Run methods #### sb.exec() ```rust theme={null} async fn exec( &self, cmd: impl Into, args: impl IntoIterator>, ) -> MicrosandboxResult ``` ```rust theme={null} let out = sb.exec("python", ["-V"]).await?; println!("{}", out.stdout()?); ``` Run a command inside the sandbox and wait for it to complete. Collects all stdout and stderr into memory and returns them along with the exit status. `cmd` is passed literally to the guest agent: the image ENTRYPOINT is **not** consulted, and `args` are not shell-interpreted. For long-running processes or large output, use [`exec_stream()`](#sb-exec_stream); for shell syntax like pipes and redirects, use [`shell()`](#sb-shell).

Parameters

cmdimpl Into\
Command to execute, e.g. "python" or "/usr/bin/node".
argsimpl IntoIterator
Command arguments, e.g. \["-c", "print('hi')"].

Returns

Collected stdout, stderr, and exit status.
#### sb.exec\_with() ```rust theme={null} async fn exec_with( &self, cmd: impl Into, f: impl FnOnce(ExecOptionsBuilder) -> ExecOptionsBuilder, ) -> MicrosandboxResult ``` ```rust theme={null} use std::time::Duration; let out = sb.exec_with("python", |e| e .args(["compute.py"]) .cwd("/app") .env("LOG_LEVEL", "debug") .timeout(Duration::from_secs(30))) .await?; ``` Run a command with per-execution overrides and wait for completion. The closure receives an [`ExecOptionsBuilder`](#execoptionsbuilder) to set args, working directory, environment variables, user, timeout, resource limits, stdin mode, and TTY allocation. These overrides apply only to this execution and don't change the sandbox's defaults.

Parameters

cmdimpl Into\
Command to execute.
Configure execution options.

Returns

Collected stdout, stderr, and exit status.
#### sb.shell() ```rust theme={null} async fn shell(&self, script: impl Into) -> MicrosandboxResult ``` ```rust theme={null} let out = sb.shell("cat /etc/os-release | grep PRETTY_NAME").await?; println!("{}", out.stdout()?); ``` Run a command through the sandbox's configured shell (default: `/bin/sh`, set via [`SandboxBuilder::shell()`](/sdk/rust/sandbox#shell)). The script is run as ` -c "