Initial monorepo — everything BlackRoad in one place

bin/       230 CLI tools (ask-*, br-*, agent-*, roadid, carpool)
scripts/   99 automation scripts
fleet/     Node configs and deployment
workers/   Cloudflare Worker sources (roadpay, road-search, squad webhooks)
roadc/     RoadC programming language
roadnet/   Mesh network (5 APs, WireGuard)
operator/  Memory system scripts
config/    System configs
dotfiles/  Shell configs
docs/      Documentation

BlackRoad OS — Pave Tomorrow.

RoadChain-SHA2048: d1a24f55318d338b
RoadChain-Identity: alexa@sovereign
RoadChain-Full: d1a24f55318d338b24b60bad7be39286379c76ae5470817482100cb0ddbbcb97e147d07ac7243da0a9f0363e4e5c833d612b9c0df3a3cd20802465420278ef74875a5b77f55af6fe42a931b8b635b3d0d0b6bde9abf33dc42eea52bc03c951406d8cbe49f1a3d29b26a94dade05e9477f34a7d4d4c6ec4005c3c2ac54e73a68440c512c8e83fd9b1fe234750b898ef8f4032c23db173961fe225e67a0432b5293a9714f76c5c57ed5fdf35b9fb40fd73c03ebf88b7253c6a0575f5afb6a6b49b3bda310602fb1ef676859962dad2aebbb2875814b30eee0a8ba195e482d4cbc91d8819e7f38f6db53e8063401649c77bb994371473cabfb917fb53e8cbe73d60

bin/blackroad-cluster

@@ -0,0 +1,63 @@
+#!/usr/bin/env bash
+# ============================================================================
+# BLACKROAD OS, INC. - PROPRIETARY AND CONFIDENTIAL
+# Copyright (c) 2025-2026 BlackRoad OS, Inc. All Rights Reserved.
+# ============================================================================
+# br-cluster — live cluster status
+set -eo pipefail
+
+source "$HOME/.blackroad/config/nodes.sh" 2>/dev/null || {
+  PINK='\033[38;5;205m'; AMBER='\033[38;5;214m'; GREEN='\033[38;5;82m'
+  RED='\033[38;5;196m'; BLUE='\033[38;5;69m'; RESET='\033[0m'
+}
+
+declare -A NODE_ROLE=(
+  [alice]="Gateway/DNS"
+  [cecilia]="AI Primary"
+  [octavia]="Storage/Gitea"
+  [aria]="Portainer"
+  [lucidia]="Services"
+  [anastasia]="Cloud Hub"
+  [gematria]="Cloud Edge"
+)
+
+case "${1:-status}" in
+  status)
+    printf '%b╔══════════════════════════════════════════╗%b\n' "$PINK" "$RESET"
+    printf '%b║%b  BLACKROAD CLUSTER                       %b║%b\n' "$PINK" "$RESET" "$PINK" "$RESET"
+    printf '%b╚══════════════════════════════════════════╝%b\n' "$PINK" "$RESET"
+
+    for node in "${ALL_NODES[@]}"; do
+      local ip="${NODE_IP[$node]:-}"
+      [[ -z "$ip" ]] && continue
+      local role="${NODE_ROLE[$node]:-Node}"
+      printf '  '
+      if br_ping "$node" 2>/dev/null; then
+        printf '%b●%b %-10s %b%-14s%b %b%s%b\n' "$GREEN" "$RESET" "$node" "$BLUE" "$role" "$RESET" "$GREEN" "$ip" "$RESET"
+      else
+        printf '%b○%b %-10s %b%-14s%b %boffline%b\n' "$RED" "$RESET" "$node" "$BLUE" "$role" "$RESET" "$RED" "$RESET"
+      fi
+    done
+    ;;
+  nodes)
+    printf '%-12s %-16s %-14s %s\n' "NODE" "IP" "ROLE" "STATUS"
+    printf '%-12s %-16s %-14s %s\n' "────" "──" "────" "──────"
+    for node in "${ALL_NODES[@]}"; do
+      local ip="${NODE_IP[$node]:-}"
+      [[ -z "$ip" ]] && continue
+      local role="${NODE_ROLE[$node]:-Node}"
+      local status="down"
+      br_ping "$node" 2>/dev/null && status="up"
+      printf '%-12s %-16s %-14s %s\n' "$node" "$ip" "$role" "$status"
+    done
+    ;;
+  ssh)
+    NODE="${2:-alice}"
+    local target
+    target=$(br_ssh_target "$NODE" 2>/dev/null) || { echo "Unknown node: $NODE"; exit 1; }
+    ssh $BR_SSH_OPTS "$target"
+    ;;
+  *)
+    echo "Usage: br-cluster [status|nodes|ssh <node>]"
+    ;;
+esac