Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.coreweave.com/llms.txt

Use this file to discover all available pages before exploring further.

Use Sandbox.shell() for interactive TTY sessions. It returns a TerminalSession with raw byte streaming and no output buffering, purpose-built for interactive use. For batch command execution, use exec() instead.

​
Shell session

session = sandbox.shell(
    ["/bin/bash"],
    width=80,
    height=24,
)
shell() always allocates a TTY and enables stdin. The returned TerminalSession streams raw bytes (no UTF-8 decode/encode round-trip), making it safe for terminal escape sequences and binary output.

​
Send commands and read output

session.stdin.writeline("echo hello").result()
session.stdin.writeline("ls -la /tmp").result()
session.stdin.writeline("exit").result()

# Iterate raw byte output
for chunk in session.output:
    sys.stdout.buffer.write(chunk)

# Get exit code
exit_code = session.wait(timeout=5.0)
TerminalSession does not buffer output. Stdout and stderr are merged into a single raw byte stream on session.output (there are no separate stdout/stderr attributes on the result). Consume session.output continuously; if you stop reading, backpressure from the bounded queue stalls the remote session.

​
Terminal resize

Send resize messages when the terminal dimensions change. 
session.resize(120, 40)
resize() is fire-and-forget on TerminalSession.

​
Exiting

End a shell session by closing stdin or sending an exit command: 
session.stdin.writeline("exit").result()  # Ask the remote shell to exit
# or
session.stdin.close().result()            # Close the stdin stream
The session completes when the remote process exits. Call session.wait() or session.result() to block for the exit code.

​
Commands and use cases

Use caseApproach
One-off command from terminalcwsandbox exec <id> echo hello
Interactive shell from terminalcwsandbox sh <id>
Run a script, capture output (SDK)exec(["python", "script.py"])
Interactive shell session (SDK)shell(["/bin/bash"])
Send input to a command (SDK)exec(["cat"], stdin=True)
Terminal application (vim, htop)shell(["vim"]) + CLI raw mode

​
See also

Last modified on April 21, 2026