RoachNet Brew

Install the native app straight from Homebrew.

Skip the setup app. Drop the shell into ~/RoachNet/app. Keep the runtime, vault, and local tools under the RoachNet folder.

View tap repo

Apple Silicon only. Fresh Homebrew installs are supported. The helper can install Homebrew first, then run the cask.

Current cask target: RoachNet 1.0.5 · brew tap AHGRoach/roachnet && brew install --cask roachnet

The direct lane writes the RoachNet config automatically, marks the first launch as a contained Homebrew bootstrap, disables the companion bridge on first boot, and skips the launch intro so the shell can come up cleanly on a fresh Mac.

Install

The short path.

Tap the RoachNet cask.

brew tap AHGRoach/roachnet

Install the native app.

brew install --cask roachnet

Open the contained app.

open ~/RoachNet/app/RoachNet.app

Use Setup.app instead

What it installs

The contained layout.

App bundle

`~/RoachNet/app/RoachNet.app`

The Homebrew lane copies the native app directly out of the packaged DMG and clears macOS quarantine metadata on the installed bundle.

Storage root

`~/RoachNet/storage`

Vault files, downloads, models, logs, and runtime state stay under the RoachNet folder instead of spilling into host-level service roots.

Local tools

`~/RoachNet/bin`

Any RoachNet-managed helper binaries and local tool shims stay alongside the app instead of being sprayed across global paths.

Config writes

`~/Library/Application Support/roachnet`

The cask writes the contained install config plus the legacy resume file so the shell knows its paths before first launch, including the Homebrew install profile and pending bootstrap state.

Homebrew runtime

What differs from Setup.app.

Portable Node

The packaged runtime ships its own portable Node lane and rejects Homebrew-linked dylib chains before the DMG is built.

Contained cache

The compiled runtime now stages in `~/RoachNet/storage/state/runtime-cache`, not `/tmp`, and native addons are re-signed there on macOS.

Safer first boot

The Homebrew lane disables the companion bridge on first launch, keeps handshake state in the RoachNet folder, and does one contained self-heal pass if the first runtime handoff comes up dirty.

Contained logs

Launcher logs, server logs, and runtime PID state now live under `~/RoachNet/storage/logs` so the Homebrew lane stays readable and self-contained.

Same API surface

Once the app is live, the Homebrew install serves the same runtime routes as the standard native install. The differences are bootstrap, layout, and first-boot defaults.

Read the API docs Tap source