nono
A secure, kernel-enforced capability sandbox for AI agents
[!WARNING] This is an early alpha release that has not undergone comprehensive security auditing or peer review. Some of the core policy files are still undergoing changes. Although care and attention has been made and the author has a long background in security, there are no guarantees regarding maturity or stability. Not recommended for production environments. Please do raise bugs, if you see something wrong, you're probably right.
nono is a secure, kernel-enforced capability shell for running untrusted AI agents and processes. Unlike policy-based sandboxes that intercept and filter operations, nono leverages OS security primitives (Landlock on Linux, Seatbelt on macOS) to create an environment where unauthorized operations are structurally impossible.
Quick Start
Homebrew (macOS)
Prebuilt Binaries
Download the latest release from the Releases page.
Build from Source
Features
- No escape hatch - Once inside nono, there is no mechanism to bypass restrictions
- Agent agnostic - Works with any AI agent (Claude, GPT, opencode, openclaw) or any process
- OS-level enforcement - Kernel denies unauthorized operations
- Destructive command blocking - Blocks dangerous commands like
rm,dd,chmodby default - Cross-platform - Linux (Landlock) and macOS (Seatbelt)
Usage
# Allow read+write to current directory
# Separate read and write permissions
# Multiple paths
# Block network access
# Dry run (show what would be sandboxed)
# Check why a path would be blocked
Command Blocking
nono blocks dangerous commands by default to prevent AI agents from accidentally (or maliciously) causing harm. This provides defense-in-depth beyond filesystem restrictions.
Blocked Commands
The following categories of commands are blocked by default:
| Category | Commands |
|---|---|
| File destruction | rm, rmdir, shred, srm |
| Disk operations | dd, mkfs, fdisk, parted, wipefs |
| Permission changes | chmod, chown, chgrp, chattr |
| System modification | shutdown, reboot, halt, systemctl |
| Package managers | apt, brew, pip, yum, pacman |
| File operations | mv, cp, truncate |
| Privilege escalation | sudo, su, doas, pkexec |
| Network exfiltration | scp, rsync, sftp, ftp |
Overriding Command Blocks
# Allow a specific blocked command (use with caution)
# Block an additional command
Kernel-Level Protection
Even if a command is allowed via --allow-command, nono applies kernel-level protection that blocks:
- File deletion -
unlink/rmdirsyscalls are blocked - File truncation - Cannot zero out files via truncation
This means even if rm is allowed, the actual deletion is blocked by the kernel:
How It Works
┌─────────────────────────────────────────────────┐
│ Terminal │
│ │
│ $ nono run --allow ./project -- agent │
│ │
│ ┌───────────────────────────────────────────┐ │
│ │ nono (applies sandbox, then exec) │ │
│ │ │ │
│ │ ┌─────────────────────────────────────┐ │ │
│ │ │ Agent (sandboxed) │ │ │
│ │ │ - Can read/write ./project │ │ │
│ │ │ - Cannot access ~/.ssh, ~/.aws... │ │ │
│ │ │ - Network: allowed (or blocked) │ │ │
│ │ └─────────────────────────────────────┘ │ │
│ └───────────────────────────────────────────┘ │
└─────────────────────────────────────────────────┘
Platform Support
| Platform | Mechanism | Kernel | Status |
|---|---|---|---|
| macOS | Seatbelt | 10.5+ | Filesystem + Network |
| Linux | Landlock | 5.13+ | Filesystem |
| Linux | Landlock | 6.7+ | Filesystem + Network (TCP) |
| Windows | - | - | Not yet supported |
Roadmap
Planned Features
| Feature | Description |
|---|---|
| Advisory API | Allow agents to preemptively check permissions before attempting operations, avoiding trial-and-error failures |
| Signed Policy Files | Policy files signed and attestable via Sigstore Rekor, with embedded DSSE signed payloads. Users can craft and sign their own default policies |
| Interactive Permission Mode | nono run --interactive spawns a supervisor that prompts when blocked operations are attempted |
| Network Filtering | Fine-grained network controls (e.g. allowlist/denylist hosts, ports, protocols) |
| Time-Limited Permissions | nono run --allow /tmp:5m -- agent grants temporary access that expires automatically |
| Learning Mode | nono learn -- command traces syscalls and generates a minimal capability profile |
| Ephemeral Mode | nono run --ephemeral creates a copy-on-write overlay filesystem where writes are isolated, enabling full undo |
| Audit Logging | nono run --audit-log ./session.jsonl -- command logs all sandbox-relevant operations for post-hoc analysis and replay |
| Windows Support | Implement a Windows version using Job Objects and Windows Sandbox |
Security Model
nono follows a capability-based security model with defense-in-depth:
- Command validation - Dangerous commands (rm, dd, chmod, etc.) are blocked before execution
- Sandbox applied - OS-level restrictions are applied (irreversible)
- Kernel enforcement - Even allowed paths cannot have files deleted or truncated
- Command executed - The command runs with only granted capabilities
- All children inherit - Subprocesses also run under restrictions
Defense Layers
| Layer | Protection | Bypass |
|---|---|---|
| Command blocklist | Blocks known-dangerous binaries | --allow-command |
| Kernel (delete) | Blocks unlink/rmdir syscalls | None |
| Kernel (truncate) | Blocks file truncation | None |
| Filesystem sandbox | Restricts path access | Explicit --allow |
| Network sandbox | Blocks network access | Remove --net-block |
License
Apache-2.0