Skip to content
@brig-sh

brig-sh

brig

Run a coding agent in a sandbox it cannot escape, with the credentials it needs and none of the ones it does not.


Install

curl -fsSL https://raw.githubusercontent.com/brig-sh/brig/main/install.sh | sh

Or with Homebrew, which also brings the macOS runtime:

brew tap brig-sh/brig
brew trust brig-sh/brig      # brew refuses untrusted third-party taps
brew install --cask brig

brig run claude

Put the projects the agent should work on in ~/brig/claude-code. That directory is the agent's entire world; the rest of your machine is invisible to it.

How it fits together

The agent runs in a guest with its own kernel. It sees one directory and the credentials you chose to forward, and nothing else -- not your keychain, not your SSH agent, not the rest of your disk. That inaccessibility is the boundary, and it is also why credentials have to be forwarded in explicitly.

brig sandbox architecture: brig run <agent> resolves the session on the host, hull over Hypervisor.framework on macOS and urunc over KVM on Linux boot it, and both give the guest the same contract

brig is not a container runtime and does not try to be one. It delegates boot, exec and stop to the runtime underneath, and adds the four things neither has a concept of: the workspace as guest home, credentials resolved on the host and forwarded per exec, a denylist for the provider keys that would silently move you onto metered billing, and signature verification of the guest image before it boots.

Supported platforms

runtime status
macOS 26+, Apple Silicon hull over Virtualization.framework supported
Linux, arm64 and amd64 urunc over containerd (io.containerd.urunc.v2) supported
macOS, Intel -- not supported

Guest images are arm64 today. Any Linux CLI in an OCI image runs as a bring-your-own image; the agent templates are convenience, not a requirement.

The repositories

brig the CLI and the session daemon
hull the microVM runtime on macOS, built on urunc
community-images guest images, with open Dockerfiles
homebrew-brig the Homebrew tap

Everything we publish is signed. Binaries carry a Developer ID signature and an Apple notarization ticket; release checksums and guest images are signed with keyless cosign, so a signature is bound to the workflow that produced it rather than to a key somebody holds.

Built on urunc

The Linux runtime, and the macOS one underneath hull, is urunc, a CNCF Sandbox project. urunc does the hard part -- it runs unikernels and lightweight VMs as OCI containers -- and hull carries that onto macOS, on top of Virtualization.framework.

Cloud Native Computing Foundation     urunc

Neither brig nor hull is a CNCF project, and neither is endorsed by the CNCF. The Linux Foundation has registered trademarks and uses trademarks. For a list of trademarks of The Linux Foundation, please see our Trademark Usage page. urunc, CNCF and the CNCF logo are trademarks of The Linux Foundation.


NOFire AI

Powered by NOFire AI

Popular repositories Loading

  1. brig brig Public

    brig: run coding agents in a microVM sandbox — the Go CLI (brig) and session daemon (brigd)

    Go 8

  2. hull hull Public

    hull: the microVM runtime brig drives on macOS (Virtualization.framework)

    Go 4

  3. community-images community-images Public

    Guest images for the coding agents brig runs, with open Dockerfiles

    Dockerfile 2

  4. homebrew-brig homebrew-brig Public

    Homebrew tap for brig — run a coding agent in a sandbox

    Ruby 2

  5. .github .github Public

    Organisation profile

Repositories

Showing 5 of 5 repositories

People

This organization has no public members. You must be a member to see who’s a part of this organization.

Top languages

Loading…

Most used topics

Loading…