This repository contains Builderbot apps, shared UI packages, and Rust crates.

# from repo root source ./bin/activate-hermit just setup

just setup runs lefthook install and pnpm install.

Then run an app:

just dev # start Staged just dev differ # start Differ

For end-user installs:

• Staged (macOS): curl -fsSL https://raw.githubusercontent.com/block/builderbot/main/apps/staged/install.sh | bash
• Differ: no standalone installer yet; run from source with just dev differ or build with just app differ build

The root justfile supports both styles:

just dev differ # verb-first (recommended for humans) just app differ dev # explicit delegation form

Useful commands:

just apps # list app names just setup # first-time setup (hooks + JS deps) just dev # run Staged app just dev differ # run Differ app just staged # alias for `just app staged dev` just differ # alias for `just app differ dev` just check # full non-modifying checks just ci # alias of `just check` just fmt # format repo just lint # lint repo just test # run Rust workspace tests

• apps/staged: main desktop app.
• apps/differ: standalone diff app.
• packages/diff-viewer: shared Svelte diff viewer package.
• crates/: shared Rust crates.
• scripts/: helper scripts used by app tooling.

Each app has its own justfile for app-specific workflows:

• apps/staged/justfile
• apps/differ/justfile

Use root delegation to run any app recipe:

just app staged ci just app differ build

• just: command not found
  • Run source ./bin/activate-hermit in your shell.
• Frontend waiting on dev server / port issues
  • Check listeners: lsof -nP -iTCP:<port> -sTCP:LISTEN
• node_modules appears at repo root
  • Expected for this pnpm workspace monorepo; app node_modules entries are symlinked into the root store.

• Staged app docs: apps/staged/README.md