Skip to content
Sign in
  • Browse all toolsFilter by category and pricing
  • Browse categoriesWriting, code, image, audio and more
  • Compare toolsPut up to three side by side
  • Read the blogGuides and comparisons

OpenShell

An open-source runtime that isolates AI agents and enforces policies for files, networks, processes, and credentials.

OpenShell is a runtime for autonomous AI agents that enforces file, process, network, and credential policies through isolated sandboxes. OpenShell serves developers and teams running agent fleets, with formal verification for policy changes and access through an open-source repository under the Apache License 2.0.

Updated 9 Nov 20266 sections

OpenShell website screenshot

What is OpenShell?

OpenShell is an open-source runtime from NVIDIA for fleets of autonomous AI agents. OpenShell provides a controlled environment where agents can read files, install packages, call APIs, and use credentials. Developers declare what each agent can access in a policy, and OpenShell enforces those permissions during execution.

OpenShell addresses the boundary between useful agent capabilities and unrestricted access to data, secrets, or networks. The project combines isolated sandboxes with kernel-level enforcement and formal verification of policy changes. The public repository includes documentation, tutorials, SDKs, contribution guidance, and an Apache License 2.0.

What OpenShell can do

OpenShell governs agent activity at runtime and checks proposed policy changes before approval. Kernel controls restrict file access and system calls, while outbound network connections pass through policy checks. Credential handling keeps real secrets away from agents and adds credentials only to requests directed at approved endpoints.

  • OpenShell runs each agent in an isolated sandbox.
  • OpenShell enforces filesystem, network, and process rules.
  • OpenShell flags risky new permissions through formal verification.
  • OpenShell injects credentials only for approved endpoints.
  • OpenShell connects applications to gateways through language SDKs.
  • OpenShell supports gateway deployment on Kubernetes with Helm.

How OpenShell works

OpenShell installation sets up the CLI and a local gateway. The quickstart then creates a sandbox using the CLI. The default image contains minimal Ubuntu without an installed agent, so the separate first-agent tutorial demonstrates running OpenCode against a free OpenRouter model and approving new access as needed.

OpenShell requires Linux, macOS on Apple Silicon, or Windows with WSL 2, plus Docker, Podman, or host virtualization. WSL 2 support is experimental. Applications can connect to gateways using Python, TypeScript, Go, or Rust SDKs, but those SDKs do not install the CLI. Matching SDK and gateway releases is recommended.

Who OpenShell is for

OpenShell serves developers and teams building or operating autonomous agents that need controlled access to files, APIs, packages, and credentials. OpenShell also provides public coding-agent skills that teach agents to use the CLI, write sandbox policies, and debug gateways and inference routing without requiring a source checkout.

  • Developers can run coding agents inside policy-controlled sandboxes.
  • Teams can review newly requested access before approving policy changes.
  • Application developers can connect software to an OpenShell gateway.
  • Kubernetes operators can deploy gateways using Helm.

OpenShell pricing and access

OpenShell is distributed as an open-source project under the Apache License 2.0. The repository provides an installation script, source code, documentation, and language SDK installation instructions. OpenShell also links to a Brev Launchable for trying the project in the cloud and documents prerelease and development builds.

OpenShell strengths and limitations

OpenShell combines runtime enforcement with review of proposed permission changes rather than relying on sandbox isolation alone. OpenShell also documents its anonymous telemetry: collection is limited to operational categories and counts, excluding prompts, credentials, file paths, and user content. Telemetry can be disabled through gateway or Helm settings, or compiled out entirely.

  • OpenShell requires a supported operating system and a container or virtualization environment.
  • OpenShell requires a separately installed agent for the default sandbox.
  • OpenShell marks Windows WSL 2 support as experimental.
  • OpenShell requires a CNI that enforces NetworkPolicy for Kubernetes deployment.

OpenShell FAQ

What is OpenShell?

OpenShell is an open-source runtime for autonomous AI agents from NVIDIA. OpenShell runs agents in isolated sandboxes, enforces access policies through kernel controls, and uses formal verification to flag risky permissions introduced by policy changes before approval.

Is OpenShell open source?

OpenShell is an open-source project licensed under the Apache License 2.0. OpenShell is available through its public repository, which includes source code, an installation script, documentation, SDKs, and guidance for contributing to development.

Which operating systems does OpenShell support?

OpenShell lists Linux, macOS on Apple Silicon, and Windows with WSL 2 as quickstart environments, with WSL 2 support marked experimental. OpenShell also requires Docker, Podman, or host virtualization and links to separate guidance for native Windows support through Microsoft MXC.

How does OpenShell protect agent credentials?

OpenShell keeps real credentials out of agents' direct view and adds credentials only to requests bound for approved endpoints. OpenShell also checks outbound network connections against policy and flags policy changes that could introduce risky new credential-bearing access.

Does OpenShell have SDKs?

OpenShell provides Python, TypeScript, Go, and Rust SDKs for connecting applications to an OpenShell gateway. OpenShell SDKs do not install the CLI, and the documentation recommends using the same release for the SDK and gateway when possible.

Does OpenShell collect telemetry?

OpenShell collects anonymous telemetry limited to operational categories and counts, excluding prompts, credentials, file paths, provider or model names, and user content. OpenShell allows telemetry to be disabled through gateway or Helm configuration, or removed entirely when compiling.

From the community

No reviews yet

Be the first to review this tool. What you write helps the next person choose.

More tools like OpenShell

CubeSandbox

www.github.com

Open-source sandbox service for AI agents with MicroVM isolation, E2B SDK compatibility, and snapshot management.

Free

ToolPermit

www.github.com

Local-first permission policies, one-time approvals, and redacted audit logs for MCP tool calls.

Free

agent-sandbox

www.github.com

Open-source Kubernetes orchestration for stateful sandboxes, AI agent runtimes, and reinforcement learning workloads.

Free

ArcBox

www.github.com

Open-source container and VM runtime for macOS with Docker compatibility, Kubernetes and isolated AI agent sandboxes.

Free