A local, open-source CLI that wraps any folder in a container so coding agents run in a comfortable but constrained environment.
At a Glance
byre is free, MIT-licensed open-source software that runs locally as a single binary for Linux and macOS.
Engagement
Available On
Alternatives
Listed Nov 2026
About byre
byre is an MIT-licensed, single-binary command-line tool by Peter Sergeant that creates a local container, called the box, around a project, worktree, or scratch directory. Running byre develop launches a coding agent such as Claude Code inside it, with your tools and defaults installed and the rest of the host kept out of reach. It runs on Linux and macOS and needs Docker or Podman on the host.
What It Is
byre is a sandboxing and environment manager for coding agents. Configuration goes in, a Dockerfile and run command come out, and the container starts. The generated files are readable, and byre dockerfile and byre dockerrun print them if you want to stop using byre. By default the agent cannot access the host filesystem, environment, or credentials such as SSH keys. The project folder and the network are open by design, and byre describes itself as guardrails rather than a security product.
Building and Changing the Box
byre ships templates for Go, Node, and Python, and agent skills for Claude Code, Codex, Gemini, Grok, and OpenCode. Skills can provide mounts, volumes, packages, and agent context. byre config opens a keyboard-driven terminal editor, which also works over SSH, for grants (mounts, ports, egress, env vars) and build settings (template, agent, packages, skills, MCP servers, instructions). Configs are layered, so a shared baseline can be reused across projects. Agent logins persist per project across rebuilds.
Workflow Commands
byre statusshows what the box can see, andbyre buildprebuilds the image.byre worktree <branch>creates a linked git worktree with a second boxed session for parallel agents.byre deliversends files or pasted images into the agent, andbyre grabretrieves files from the box.byre mcp addadds MCP servers.byre develop --self-editlets the agent edit its own box config, and the changes are shown on exit.byre backupandbyre restoremove a box to another machine.
Current Status
The README describes byre as a young project and points readers to a maturity note on the install page. The latest release listed is v1.14.0.
Community Discussions
Be the first to start a conversation about byre
Share your experience with byre, ask questions, or help others learn from your insights.
Pricing
Open Source
byre is free, MIT-licensed open-source software that runs locally as a single binary for Linux and macOS.
- MIT licensed
- Local container around any folder
- Single binary
- No lock-in
- For Linux and macOS
Capabilities
Key Features
- Local container sandbox around any folder via `byre develop`
- Terminal config editor (`byre config`) that works over SSH
- Templates for Go, Node, and Python
- Agent skills for Claude Code, Codex, Gemini, Grok, and OpenCode
- Persistent per-project agent logins across rebuilds
- Optional firewall skill with egress control
- Git worktree support for parallel agents
- MCP server configuration
- File delivery into and out of the box (`byre deliver`, `byre grab`)
- Layered configs and shareable presets
- Self-edit mode for agent-managed box config
- Readable generated Dockerfile and run command
- Backup and restore of boxes
