Shell

Opening a Shell

oc shell sb-abc123

Opens a full interactive terminal over WebSocket. Press Ctrl+D or type exit to disconnect.

Choosing a Shell

oc shell sb-abc123 --shell /bin/zsh

Default: /bin/bash.

What Works

The PTY supports everything you’d expect from a real terminal:

Editors: vim, nano
Monitors: top, htop
Tab completion and command history
Colors and ANSI escape codes
Terminal resizing — automatic, resize events forwarded

Full-screen applications like tmux and less work correctly.

Shell vs Exec

Use Case	Command
Run a single command, capture output	`oc exec --wait`
Scripting and automation	`oc exec --wait --json`
Interactive development	`oc shell`
Debugging	`oc shell`

Tips

Create and Shell In

oc shell $(oc create --json | jq -r '.sandboxID')

Shell with Custom Environment

Set up the environment before shelling in:

ID=$(oc create --json | jq -r '.sandboxID')
oc exec $ID --wait -- bash -c 'echo "export PATH=/app/bin:\$PATH" >> ~/.bashrc'
oc shell $ID

SDK usage: Interactive Terminals. Full flags: CLI Reference.

Running Commands Checkpoints

⌘I

Getting Started

Sandboxes

Browser Sessions

Durable Agent Sessions

Reserved Capacity

CLI

Guides

TypeScript SDK

Python SDK

CLI Reference

API Reference

Resources

Opening a Shell

Choosing a Shell

What Works

Shell vs Exec

Tips

Create and Shell In

Shell with Custom Environment

​Opening a Shell

​Choosing a Shell

​What Works

​Shell vs Exec

​Tips

​Create and Shell In

​Shell with Custom Environment

Opening a Shell

Choosing a Shell

What Works

Shell vs Exec

Tips

Create and Shell In

Shell with Custom Environment