Alexa Amundson
78fbe80f2a
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
83 lines
2.9 KiB
Bash
Executable File
83 lines
2.9 KiB
Bash
Executable File
#!/usr/bin/env bash
|
|
# br-help - BlackRoad OS unified help system
|
|
# Lists all available commands with descriptions parsed from script headers
|
|
set -o pipefail
|
|
|
|
PINK='\033[38;5;205m'
|
|
AMBER='\033[38;5;214m'
|
|
BLUE='\033[38;5;69m'
|
|
VIOLET='\033[38;5;135m'
|
|
GREEN='\033[38;5;82m'
|
|
RESET='\033[0m'
|
|
|
|
BIN_DIR="$HOME/bin"
|
|
|
|
# Extract description from script header
|
|
get_desc() {
|
|
local file="$1"
|
|
[[ -f "$file" ]] || return
|
|
# Skip shebang, separators (===), copyright, blank # lines; take first real comment
|
|
head -15 "$file" 2>/dev/null | \
|
|
grep '^#' | \
|
|
grep -v '^#!' | \
|
|
grep -v '^# *=\{3,\}' | \
|
|
grep -v -i 'copyright\|proprietary\|confidential\|license\|unauthorized\|intellectual\|ai-assisted\|NOT licensed\|All Rights' | \
|
|
grep -v '^# *$' | \
|
|
head -1 | sed 's/^# *//' | cut -c1-60
|
|
}
|
|
|
|
show_category() {
|
|
local label="$1"; shift
|
|
local color="$1"; shift
|
|
local commands=("$@")
|
|
printf "\n%b %s%b\n" "$color" "$label" "$RESET"
|
|
for cmd in "${commands[@]}"; do
|
|
local path="$BIN_DIR/$cmd"
|
|
if [[ -x "$path" ]] || [[ -f "$path" ]]; then
|
|
local desc
|
|
desc=$(get_desc "$path")
|
|
printf " %b%-22s%b %s\n" "$GREEN" "$cmd" "$RESET" "${desc:-—}"
|
|
fi
|
|
done
|
|
}
|
|
|
|
printf '%b╔══════════════════════════════════════════════════╗%b\n' "$PINK" "$RESET"
|
|
printf '%b║ BlackRoad OS Command Reference ║%b\n' "$PINK" "$RESET"
|
|
printf '%b╚══════════════════════════════════════════════════╝%b\n' "$PINK" "$RESET"
|
|
|
|
show_category "CORE" "$PINK" \
|
|
blackroad brctl bros road roadid fleet mesh blackroad-shell
|
|
|
|
show_category "AI HUB" "$VIOLET" \
|
|
br-ai br-infer br-fleet-ai br-models ai blackroad-ai ask br-code-assistant
|
|
|
|
show_category "AGENTS & ORCHESTRATION" "$VIOLET" \
|
|
blackroad-agent blackroad-agents agent-collab agent-swarm agent-worker \
|
|
claude-agent roundtable rt-ask rt-context
|
|
|
|
show_category "LLM PROVIDERS" "$GREEN" \
|
|
llama ollama-os gemini-cli gemmy grok-cli
|
|
|
|
show_category "FLEET AI (ask-*)" "$AMBER" \
|
|
ask-node ask-alice ask-cecilia ask-octavia ask-lucidia ask-aria
|
|
|
|
show_category "STATUS & MONITORING" "$BLUE" \
|
|
br-status br-stats br-dashboard br-stats-enhanced
|
|
|
|
show_category "DEPLOYMENT & INFRA" "$AMBER" \
|
|
br-deploy br-pack br-hw br-sync br-run bb-deploy
|
|
|
|
show_category "DEVELOPMENT" "$GREEN" \
|
|
br-search br-index brc brx br-generate
|
|
|
|
show_category "NETWORK & SECURITY" "$BLUE" \
|
|
br-security br-send cf-dns blackroad-mesh blackroad-gateway
|
|
|
|
show_category "MEDIA & BRAND" "$VIOLET" \
|
|
br-video br-video-create br-art br-gui br-palette br-shape
|
|
|
|
# Count available commands
|
|
total=$(find "$BIN_DIR" -maxdepth 1 -type f -perm +111 2>/dev/null | wc -l | tr -d ' ')
|
|
printf "\n%b %s commands in ~/bin/%b\n" "$PINK" "$total" "$RESET"
|
|
printf " Run any command with --help for details\n\n"
|