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.




