delta-box/deltabox-lite
Lightweight, agent-native sandboxing with diff, commit and abort
What it solves
AI coding agents need to execute commands in a project without fear of making unintended changes. deltabox-lite solves this by providing a confined filesystem view where every modification can be reviewed, committed, or aborted before it becomes final. This gives agents full execution freedom while keeping human control over exactly what gets accepted.
How it works
Deltabox uses native OS isolation: Linux combines Sandlock/Landlock/seccomp with a FUSE filesystem (DeltaFS), macOS uses Seatbelt with APFS clones and FSEvents, and Windows uses process security (MXC) with WinFsp filesystem routing. Sessions are durable but service-free — no global daemon is needed. It supports three filesystem modes:
- cbcow-through (default): changes appear immediately, and commit is an O(1) acceptance step.
- cbcow-private: runs the same engine over a private copy-on-write tree; only touched paths are published at commit.
- copy-private: a compatibility fallback with a private working tree.
Commands run inside a session, and you can diff before committing or aborting. A linear checkpoint chain supports rollback. Policies can restrict filesystem access, network targets, and resource limits. The tool integrates with the Pi coding agent and DeepSeek Harness via plugins, and provides a command-line interface plus a native Node API.
Who it's for
Developers and teams who use AI coding agents and want to run agent commands safely inside a project. It is designed for users who want to review exactly what an agent changed and selectively keep or discard those changes, especially in terminal-based workflows. Both casual and advanced users benefit from the simple run command for one-off transactions and the more powerful persistent session mode for multi-step work.
Highlights
- Native isolation per OS (no containers required)
- Service-free durable sessions with automatic helpers
- Three filesystem modes:
cbcow-through,cbcow-private,copy-private - Unified diff/commit/abort with binary and large-file markers
- Review-scope savepoints for task or tool adapters
- Optional JSON-RPC adapter protocol for Pi and other agents
- Policy-first design: deny secret paths, network allow/audit, writable limits
- Install via npm, Homebrew, install script, or prebuilt binaries
Related
- Project
- Project
- Project
- Project