NVIDIA · NVIDIA OpenShell: Open-Source Sandboxed Runtime for AI Agents
NVIDIA OpenShell is an open-source (Apache 2.0) runtime that runs existing AI agents, such as Claude Code, Codex, OpenCode, or GitHub Copilot CLI, inside kernel-isolated sandboxes governed by YAML policies. It controls which files, network destinations, and credentials each agent can use, and checks proposed policy changes before they are approved. It suits developers and platform teams who want to give agents real access without giving them unrestricted access to their machines, secrets, or network.
Best for
Developers and platform or security teams who run coding or autonomous agents with real file, network, and credential access and want enforceable, reviewable limits outside the agent itself
Not ideal for
Anyone looking for an agent to do the work, teams without the Linux, container, or Kubernetes skills to maintain images and policies, and hosts on older kernels or Windows where support is limited or experimental
Who it's for
Developers running coding agents locally, and platform, security, and infrastructure teams responsible for how agents access code, credentials, and networks
OpenShell addresses a gap that most coding agents leave to their users: permission prompts inside the agent are not a security boundary, and agents run with whatever access their user account has. OpenShell moves enforcement to the kernel and a supervisor the agent cannot reach, and its best idea is keeping real credentials out of the sandbox entirely. The policy advisor and prover make least-privilege workable, because access can grow as the agent needs it and each change is checked first. The costs are operational. You own the images, the policies, and the kernel requirements, and on Kubernetes the guarantees are only as strong as your CNI. For teams already letting agents touch real code and secrets, it is a strong option to evaluate, and solo developers can try it with Docker on a laptop.
Who should use it
Developers who let coding agents run commands on real projects, and platform or security teams that need to prove what agents can access, keep credentials out of agent reach, and review access changes before they take effect.
Who should skip it
People looking for an agent rather than infrastructure, teams unwilling to maintain container images and YAML policies, and environments on older kernels, native Windows, or Kubernetes clusters without NetworkPolicy enforcement.
Open source
Free
Note: NVIDIA lists no paid edition of OpenShell. Costs come from the infrastructure you run it on and the model APIs your agents call. The Sentry watchdog in NVIDIA's Open Agent Safety Platform requires BlueField-4 DPU hardware and is separate from the OpenShell software.
Letting a coding agent work on a private repository
Filesystem rules confine the agent to the workspace, the default network policy blocks uploads to unapproved hosts, and the model and Git credentials only reach their own endpoints.
Least-privilege access that grows with the task
Instead of guessing every domain up front, you start restrictive. The policy advisor drafts a rule for each blocked request, the prover flags risky ones, and you approve what is needed without restarting the sandbox.
Standard agent guardrails across a team
A gateway administrator can apply a global policy to every sandbox, and `openshell-prover` can check in CI that team policies never exceed an approved boundary.
NVIDIA OpenShell and Claude Code
Claude Code is the agent: it reads the codebase, edits files, and runs commands, with its own permission prompts. OpenShell can run Claude Code as a sandbox's main process and enforce, outside the agent, which paths it can touch, which hosts it can reach, and where its Anthropic API key can be sent.
NVIDIA OpenShell and OpenCode
OpenCode is an open-source coding agent that works with many model providers. OpenShell's getting-started guide runs OpenCode against OpenRouter inside a sandbox, where the OpenRouter credential is sent only to openrouter.ai and new network access is requested and approved as the agent works.
NVIDIA OpenShell and Pi Coding Agent
Pi is a minimal coding agent that runs with its user's permissions and does not ask before each tool call. OpenShell supplies the boundary around it: OpenShell's Run Pi with OpenRouter tutorial builds a Pi image and runs it with narrowly scoped OpenRouter access inside a sandbox.
What is NVIDIA OpenShell?
OpenShell is NVIDIA's open-source runtime for running autonomous AI agents in sandboxes. Each agent runs inside a kernel-isolated boundary, and a trusted supervisor enforces a YAML policy on file access, processes, network connections, and credentials. A gateway manages sandboxes, policies, and providers.
Is OpenShell an AI agent?
No. OpenShell does not plan or write code itself. It runs agents you already use, such as Claude Code, Codex, OpenCode, GitHub Copilot CLI, or Pi, as the main process of a sandbox, and controls what they can reach.
Is OpenShell free and open source?
Yes. The code is on GitHub at NVIDIA/OpenShell under the Apache 2.0 license, and NVIDIA lists no paid edition of the software. You still pay for any model APIs your agents call and for the infrastructure you run it on.
How does OpenShell protect credentials?
Credentials are stored as providers on the gateway side. The sandbox receives only opaque placeholders, and the supervisor substitutes the real value on requests to endpoints that the provider profile authorizes. A leaked environment variable or a request to an unapproved host does not carry the real key.
What platforms does OpenShell support?
The CLI and gateway are supported on Debian and Ubuntu Linux (x86_64 and arm64) and on Apple Silicon macOS with Docker Desktop. Windows with WSL 2 and Docker Desktop is experimental. Sandboxes run on Docker, Podman, Kubernetes 1.29+ through the Helm chart, or libkrun microVMs. The sandbox boundary needs Landlock ABI 3 (Linux 6.2 or newer) and specific seccomp support; on macOS these run inside the Docker Desktop Linux VM.
Can OpenShell run on Kubernetes?
Yes. The gateway is deployed with a Helm chart and provisions sandboxes through the Kubernetes SIG Agent Sandbox controller, which must be installed first. The cluster needs Kubernetes 1.29+ with RBAC and a CNI that enforces NetworkPolicy for both ingress and egress, otherwise workloads could bypass policy.
What is the difference between OpenShell and NVIDIA Sentry?
OpenShell is the open-source software runtime. Sentry is part of NVIDIA's Open Agent Safety Platform reference design: an out-of-band watchdog that runs on BlueField-4 DPUs, monitors agent behavior, and can quarantine an agent that tries to leave its software boundary. You can use OpenShell without Sentry.
Does OpenShell collect telemetry?
Yes, anonymous operational telemetry limited to categories and counts. NVIDIA says it does not collect sandbox names, hostnames, file paths, prompts, credentials, provider or model names, or user content. Set `OPENSHELL_TELEMETRY_ENABLED=false` on the gateway, or `server.telemetryEnabled=false` for Helm installs, to turn it off.
OpenShell is not an agent. It is the boundary you run an agent inside. A gateway acts as the control plane, and for each sandbox a compute driver starts the agent's workload next to a separate, trusted supervisor. Inside the workload the agent runs as a non-root user with no Linux capabilities, Landlock limits which paths it can read or write, and seccomp hands every TCP connection and DNS lookup to the supervisor, which checks it against policy before opening the real connection. Network access is denied by default. Policies allow specific destinations per program and can restrict the requests sent, for example read-only access to an API. Credentials are stored as providers, and the agent only sees placeholders, which the supervisor swaps for the real key on requests to endpoints the provider profile allows. When the agent hits a blocked destination, OpenShell drafts a narrow rule, and a policy prover that uses an SMT solver checks it for risky new access, such as credentialed reach to a new host or cloud metadata endpoints, before a human approves it. Approved rules hot-reload without restarting the sandbox. Sandboxes run on Docker, Podman, Kubernetes (Helm), or microVMs, can request NVIDIA GPUs, and use standard Linux OCI images, so you bring an image that already contains your agent. OpenShell 0.1.0 (September 25, 2026) moved the project to a stable release cadence, with tagged stable releases generally every week. Three days later NVIDIA declared OpenShell broadly available as the open-source software part of its Open Agent Safety Platform, which also includes the Sentry watchdog reference design for BlueField-4 DPUs. The tradeoffs are setup and scope. You write or adapt policies and images yourself, Linux hosts need a recent kernel with Landlock and specific seccomp features, Kubernetes needs a CNI that enforces NetworkPolicy, and the prover does not yet cover every policy feature.
NVIDIA announced the Open Agent Safety Platform, pairing OpenShell with the Sentry watchdog reference design for BlueField-4 DPUs, and said OpenShell is now broadly available. The announcement lists Anthropic, Salesforce (a Slack integration for approving OpenShell requests), SAP, and Scale AI among the organizations working with the platform.
OpenShell 0.1.0 introduced a stable release cadence, new isolation primitives, an expanded extension surface, and new APIs. It includes breaking changes: 0.0.x installations cannot be upgraded in place and must be uninstalled, and existing sandboxes must be recreated.
Are you the founder? Claim this listing →