NVIDIA OpenShell: kernel-enforced agent sandboxes with verified policy changes
An open-source runtime that sandboxes coding agents with kernel-level policy and hidden credentials, for devs giving agents real access.
Picture a two-person consultancy where one developer runs Claude Code against a client's repo most afternoons. To be useful, the agent has to install packages, run tests, hit the GitHub API and call a model endpoint, so the developer's tokens sit in a .env file the agent can read. That leaves two settings. One is to approve every command by hand, which kills the speed that made the agent worth using. The other is to let it run loose and hope it never reads the wrong directory, posts somewhere unexpected, or uses a write-scoped token when the task only needed reads. Neither option leaves a record the client would accept if they asked what the agent touched.
On September 28, 2026, NVIDIA announced its Open Agent Safety Platform. The software core, OpenShell, targets that gap. It is an open-source runtime where you declare what each agent may touch, the kernel enforces it, and the agent never holds the real credentials. The platform's hardware layer, Sentry, needs BlueField-4 DPUs, but OpenShell itself runs on ordinary Linux, Apple Silicon and WSL 2 machines (AiCybr).
What it is
Per the project README, OpenShell governs agents in two ways. It instruments the kernel to enforce policy on every file access, system call and network connection, and it uses formal verification to check what a policy change would allow before the change is applied. Mapped to the lede:
- Isolated sandbox per agent. Kernel controls limit which files the agent can read or change and which system calls it can make. AiCybr reports that the docs name Landlock for filesystem limits and seccomp for process limits. This addresses the agent wandering outside the project directory.
- No network path except through a supervisor. The NVIDIA Technical Blog says the supervisor can inspect configured HTTP, GraphQL and MCP traffic. That lets it allow a data query while blocking a write through the same API. NVIDIA says these controls stay in place when the agent starts a shell, runs generated code, launches child processes or proposes delegating to sub-agents. This addresses the write-scoped token problem. As ServeTheHome puts it, receiving services still enforce their own permissions, and OpenShell adds a separate control over how the agent uses them.
- Credentials as placeholders. The README says agents never see real credentials, and OpenShell adds them only to requests bound for approved endpoints. AI/TLDR describes them as opaque placeholders resolved only at profile-authorized endpoints. This addresses the readable
.envfile. - Verified policy changes. When an agent needs access its policy doesn't grant, it proposes a rule, and you approve or reject it from the host (AI/TLDR). Before approval, the README says formal verification flags risky new access, such as reaching a new host with credentials or calling a new API method, so those changes wait for human review. AI/TLDR adds access to cloud metadata endpoints to the list of flagged changes.
- Audit trail. Policy decisions are recorded in an Open Cybersecurity Schema Framework (OCSF) audit trail, according to NVIDIA's blog.
Policies are written in YAML and compiled to OPA/Rego, which OpenShell evaluates for each outbound request (NVIDIA blog). BazaarLink notes the files can live in version control. The project is Apache 2.0 and ships SDKs for Python, TypeScript, Go and Rust. BazaarLink reports that v0.1.0 shipped September 25 and v0.1.2 shipped September 28. NVIDIA's blog lists Codex, Claude Code, Pi and Hermes as supported agents, and BazaarLink says the docs also use OpenCode and GitHub Copilot CLI as examples.
Alternatives and adjacent options, described only from their sources:
- 1Password for NVIDIA OpenShell (beta). This is a layer on top of OpenShell rather than a replacement. It maps a 1Password Environment to an OpenShell provider profile with a destination, an expiration and read/write scope. After the TTL expires, OpenShell stops resolving the credential. Trade-off: you get real secret lifecycle management, at the cost of a beta dependency.
- NVIDIA NemoClaw. AI/TLDR describes it as NVIDIA's reference stack for running OpenClaw, Hermes and LangChain Deep Agents Code inside OpenShell sandboxes. Trade-off: it is a more packaged stack on the same runtime.
- E2B and Daytona. AI/TLDR describes E2B as isolated cloud sandboxes controlled from JavaScript or Python SDKs, and Daytona as an open-source runtime that spins up isolated sandboxes in under 90ms. Trade-off: no source here compares their policy or credential models with OpenShell's, so evaluate those separately.
Who it's for
Pick it up if you run a coding agent that needs a shell, packages and API keys but must not reach the rest of your machine or network. It also fits if you want to approve each new network destination an agent asks for, or if you run several agents and want one gateway holding their policies and credentials. NVIDIA's blog cites Cadence, Slack and Gecko Robotics as adopters, and Technobezz reports integration work at Salesforce, SAP and Scale AI. Those are vendor-reported deployments, not field reports.
Skip it for now if you need a tool with independent security validation before it touches client systems. BazaarLink found that most coverage restates the press release. Also skip it if your workflow is Windows-native, since WSL 2 support is marked experimental. And skip it if you were hoping for hardware-backed isolation on commodity machines, because Sentry requires BlueField-4.
Before and after
Today (hypothetical consultancy):
- Export tokens into the shell or
.env, where the agent can read them. - Start the agent with broad permissions, or babysit approval prompts.
- Hope the agent stays within the repo and uses read-only calls when it should.
- Reconstruct what happened from shell history if a client asks.
With OpenShell:
- Create a provider from your existing key. AI/TLDR's walkthrough of the first-agent guide imports an OpenRouter provider profile and notes the agent never sees the raw key.
- Create a sandbox with a YAML policy, attach the provider and pass the agent command.
- When the agent hits a wall, it proposes a rule. The prover flags risky reach, and you approve or reject from the host. ServeTheHome reports that swapping a network policy takes one command and needs no sandbox restart.
- Answer the client from the OCSF audit trail and
openshell logs.
Try it
The README's quickstart requires Linux, macOS on Apple Silicon, or Windows with WSL 2 (experimental), plus Docker, Podman or host virtualization:
curl -LsSf https://raw.githubusercontent.com/NVIDIA/OpenShell/main/install.sh | sh
openshell sandbox create --name demo
The installer sets up the CLI and a local gateway. The default sandbox is minimal Ubuntu with no agent installed. The README points to the "Run Your First Agent" guide, which runs OpenCode against a free OpenRouter model and shows how to approve new access. BazaarLink advises reading any curl | sh script before running it.
To see enforcement without an API key, NVIDIA's blog creates a sandbox from a no-network policy and then swaps in a read-only GitHub policy:
openshell sandbox create --name policy-demo \
--no-auto-providers \
--policy examples/no-network.yaml
network_policies:
github_api:
name: github-api-readonly
endpoints:
- host: api.github.com
port: 443
protocol: rest
enforcement: enforce
access: read-only
binaries:
- path: /usr/bin/curl
Download the original policy files from the blog post rather than retyping this one, since indentation matters in YAML. The blog checks blocked requests with openshell logs policy-demo --since 5m. The README also offers agent skills (npx skills add NVIDIA/OpenShell) that teach your coding agent to drive the CLI and write policies.
On cost: OpenShell is Apache 2.0, and no pricing was disclosed (Technobezz). Anonymous telemetry is on by default. The README says it can be disabled with OPENSHELL_TELEMETRY_ENABLED=false on the gateway.
Where it breaks
- It is days old. BazaarLink notes the v0.1.x releases all landed within one week. ServeTheHome reads the 0.1.0 versioning as a sign there is still a lot of work to do.
- Filesystem rules are fixed at creation. AI/TLDR says filesystem and process rules lock when the sandbox is created, while network rules can be hot-reloaded. Changing file access means recreating the sandbox.
- Provider rough edges. Issue #3304, filed against 0.0.116, reports that policy-only provider profiles with
credentials: []can't be instantiated without a dummy secret. Whether 0.1.x fixes this isn't stated. - A software sandbox has limits. BazaarLink cites a report that an agent compromising the host OS can escape software-level controls. That is Sentry's job, and Sentry needs BlueField-4 hardware.
- Policy design is still your job. As BazaarLink puts it, an overly broad policy makes the sandbox a formality.
- Vendor-run tests only. ServeTheHome relays NVIDIA's adversarial experiments: agents spent up to two hours trying to persuade AI reviewers to grant write permissions on protected repositories, and no protected writes occurred. These are NVIDIA's results, not an independent audit.
- Unconfirmed: what a minimal single-agent policy looks like (check the docs or repo); how placeholder credentials behave for tools that need raw tokens locally, such as SDK signing, CLI token files or localhost dev servers; which verification engine is used, and whether it covers filesystem or syscall changes or exfiltration through already-approved endpoints; and how OpenShell compares directly with E2B or Claude Code's own sandbox. None of these is answered in the sources.
Sources
- GitHub - NVIDIA/OpenShell: OpenShell is the safe, private runtime for autonomous AI agents. · GitHub
- NVIDIA Open Agent Safety Platform Pairs OpenShell Sandboxes With BlueField-4 Sentry · AiCybr
- Add Runtime Controls to AI Agents with NVIDIA OpenShell | NVIDIA Technical Blog · NVIDIA Technical Blog
- NVIDIA Open Agent Safety Platform Launched · ServeTheHome
- NVIDIA Debuts Open Agent Safety Platform With OpenShell, Sentry · Technobezz
- NVIDIA OpenShell — sandboxed runtime for autonomous agents · AI/TLDR
- NVIDIA OpenShell Explained: Sandboxes and Credential Protection · BazaarLink
- Issue · NVIDIA/OpenShell · GitHub
- Secure agent access in development workflows with 1Password + NVIDIA OpenShell | 1Password · 1Password