RoachNet logo
Apple Silicon · one command · one folder RoachNet Brew
brew install --cask
Account API GitHub

RoachNet Brew

Terminal type? Three commands to ~/RoachNet.

Same app, same folder, same easy goodbye if you change your mind. This way skips the setup window entirely and lets Homebrew do the walking.

Apple Silicon only. Assumes Homebrew is already installed. If it is not, install it first, then come back. RoachNet is not going anywhere.

Installs RoachNet 1.0.5 · DMG SHA-256 332057c4f85d136882971957d907bec82e7657833272d30d0849990590e1d122 · brew update && brew tap --force RoachWares/roachnet && brew install --cask roachnet

The cask sets up its own config, clears only the macOS flags that would block launch, and runs on its own bundled tools rather than borrowing yours.

Install

Three steps. Same destination.

1

Add the tap.

brew update && brew tap --force RoachWares/roachnet

2

Install the cask.

brew install --cask roachnet

3

Launch.

open ~/RoachNet/app/RoachNet.app

Use Setup.app instead

What it installs

What lands on disk.

App bundle

~/RoachNet/app/RoachNet.app

The same download the Setup app uses, unlocked so macOS will open it without an argument.

Storage root

~/RoachNet/storage

Models, logs, vault, and everything else live here. Nothing gets scattered into /usr/local, /tmp, or some staging folder you'll never find again.

Local tools

~/RoachNet/bin

Helper tools sit right next to the app. Clean install, clean uninstall, nothing left behind for future-you to curse at.

Config writes

~/Library/Application Support/roachnet

Settings land here so the app knows where everything is the first time it opens. No setup scavenger hunt.

Homebrew runtime

More than a brew install in a trenchcoat.

Portable Node

Brings its own Node. Your global install stays exactly as you left it, whatever Homebrew decided to upgrade this week.

Launch-safe

Clears the macOS quarantine flags that stop a fresh download from opening — and only those. Nothing else gets touched.

Cache that stays put

Cache lives in ~/RoachNet/storage/state/runtime-cache, not /tmp. It will not vanish on reboot and act surprised next launch.

Safer first boot

Remote access is off until you turn it on. And if the first launch goes sideways, RoachNet tries to fix itself once before it bothers you about it.

Logs in one place

All logs live in ~/RoachNet/storage/logs. When something breaks, you know exactly where to look.

Identical either way

Same API, same behaviour as the Setup.app install. Only the way it gets there is different.

Checksum

332057c4f85d136882971957d907bec82e7657833272d30d0849990590e1d122. Setup app and Homebrew pull the exact same file, straight from the public release. Check it yourself.

Read the API docs