Secure AI agent file access and API calls with policy-driven enforcement
When an AI agent opens files, installs packages, or calls APIs, your data and secret keys are at risk. OpenShell provides an execution environment that allows agents to use necessary features while strictly blocking access to restricted areas. By defining what an agent can do through policies, the system automatically enforces those rules.
CNCF membership and 0.1.x version changes
OpenShell is now part of the CNCF (Cloud Native Computing Foundation), and development has moved to the ai-openshell/openshell repository. The latest 0.1.x versions introduce a stable release cycle, new isolation primitives, an extended extension surface, and new APIs. When upgrading from previous versions, it is recommended to check the 0.1.0 upgrade guide.
Kernel-level enforcement and schema validation
OpenShell controls agent behavior in two ways. First, it instruments the kernel to enforce policies in real time for all file access, system calls, and network connections. Each agent runs in an isolated sandbox where actual credentials are invisible and are only added to requests for approved endpoints. Second, schema validation detects dangerous new accesses (such as reaching a new host with credentials) before policy changes are applied, holding them for human review.
Installation and first run
Docker, Podman, or host virtualization is required on Linux, Apple Silicon-based macOS, or Windows with WSL 2 (experimental). Running the installation script sets up the CLI and local gateway, with the default sandbox image being a minimal Ubuntu without an agent. To run an actual agent, follow the guide for using OpenCode with a free OpenRouter model, which lets you experience the process of approving new accesses required by the agent.
Extensibility and SDK support
OpenShell supports various areas including sandboxes, policies, providers, gateways, Kubernetes deployment, and extensibility (middleware, interceptors, compute drivers). You can connect applications to the OpenShell gateway using Python, TypeScript, Go, and Rust SDKs, without installing the CLI. Additionally, a public skill that helps coding agents drive the OpenShell CLI and write sandbox policies can be installed with the npx skills add ai-openshell/openshell command.
Pre-use considerations
OpenShell is licensed under the Apache License 2.0, and the software is provided 'AS IS' without warranty. Because it automatically searches and interacts with external materials, users must verify the security and appropriateness of those materials themselves. Anonymous telemetry collects only operational categories and counts, not sandbox names, file paths, prompts, or credentials. To disable telemetry, set OPENSHELL_TELEMETRY_ENABLED=false in the gateway or specify server.telemetryEnabled=false during Helm installation.