AI Jail — AI skill for Claude Code
Multi-OS sandbox to run AI agents with better constraints (it is not 100% secure, but enough).
How to install AI Jail
This entry records only its repository, not the path inside it, so there is no
exact command to give. Open zeo-workspace/ai-jail and copy the folder into
~/.claude/skills/, or the file into ~/.claude/agents/.
What AI Jail does
Multi-OS sandbox to run AI agents with better constraints (it is not 100% secure, but enough).
Alternatives in AI
- Impeccable — The design language that makes your AI harness better at design 13.9k ★
- Better Harness — Review this project's AI coding workflow with Better Harness and generate a durable report 2.1k ★
- Ante — Ghost in your shell 1.9k ★
README
ai-jail
**[aijail.io](https://aijail.io)**
`ai-jail` runs AI coding agents in an OS sandbox: bubblewrap plus Landlock, seccomp, and limits on Linux; `sandbox-exec` on macOS.
What ai-jail is (and isn't)
ai-jail is **not** a lockdown or hard-security tool, and it is **not** a boundary against malware or other hostile code — for that, use a disposable VM. Its job is to be **developer-friendly**: it defends against a trusted-but-fallible agent's mistakes, not against a motivated attacker actively trying to escape.
Concretely, that means your dev tools and the invoked agent's own credentials are available **by default** — which is explicitly not a lockdown-secure posture — with flags to progressively turn capabilities off. The goal is to prevent _accidents_: an LLM running a mistyped command that deletes unrelated important files outside the project, for example. With the project directory as the blast radius, you can confidently turn on "YOLO mode" (auto-accept, no confirmation prompts) in an AI harness with reasonable confidence it won't damage anything outside the project scope.
It is a useful accident-prevention layer, not a replacement for a disposable VM when running hostile code. See [docs/SECURITY.md](docs/SECURITY.md) for the full threat model.
Install
# Homebrew
brew tap akitaonrails/tap && brew install ai-jail
# Arch Linux
yay -S ai-jail-bin # prebuilt Linux x86_64 binary
yay -S ai-jail # build from source
# crates.io
cargo install --locked ai-jail
# Nix (flake) — sets BWRAP_BIN automatically
nix run github:akitaonrails/ai-jail -- claude
nix profile install github:akitaonrails/ai-jail
# GitHub Releases (signed archives, checksums alongside)
# ai-jail-linux-x86_64.tar.gz / ai-jail-macos-aarch64.tar.gz
Build from source with Rust `1.97.1`:
cargo build --release --locked
install -Dm755 target/release/ai-jail ~/.local/bin/ai-jail
Linux requires `bwrap` (`bubblewrap`): `pacman -S bubblewrap`, `apt insta
Related Skills
Claude Code Wsl Sandbox
Run Claude Code on Windows inside a real Linux sandbox. WSL 2 + ai-jail (bubblewrap, Landlock, seccomp) so the
UI Agent Constraints
Agent Skill: A skill that provides opinionated constraints and guidelines for building better user interfaces
Mino
Secure sandbox for AI coding agents. Temporary credentials, filesystem isolation, persistent caching.
AI Agent Sandbox
A secure bubblewrap-based sandboxing solution for running Claude Code with strict filesystem isolation.
Dozer Sandbox
Fast, resumable, secure Linux sandboxes for AI coding agents on your Mac — your API keys never go inside.
Nullkey
Desktop-grade secure sandbox for AI coding agents. Keys never enter the sandbox.
Related Agents
Runtime Platform
Read-only runtime and platform specialist for toolchain, sandbox, environment, and OS behavior. Invoke when en
Context Pack
Creates structured handoff briefings between agents. Packages task context, constraints, progress into compact
Npl PRD Editor
Transforms user stories and feature requests into well-structured PRD documents under project-management/PRDs/