Files

Alexa Amundson 78fbe80f2a 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

2026-03-14 17:08:41 -05:00

2.6 KiB

Raw Blame History

CLAUDE.md

This is blackroad-scripts - the BlackRoad OS home directory (400+ shell scripts, CLI tools). See ~/.claude/CLAUDE.md for infrastructure context.

Development Commands

shellcheck ~/script-name.sh  # Lint bash scripts
bash -n ~/script-name.sh     # Syntax check only
bash -x ~/script-name.sh     # Debug mode (trace execution)
npm run dev                  # Wrangler dev server
npm run deploy              # Deploy to Cloudflare

Writing Scripts

Standard Header

#!/bin/bash
# Description of what this script does
# Usage: ./script-name.sh [args]

set -e  # Exit on error

Color Constants (BlackRoad Brand)

PINK='\033[38;5;205m'   # Hot pink (#FF1D6C)
AMBER='\033[38;5;214m'  # Amber (#F5A623)
BLUE='\033[38;5;69m'    # Electric blue (#2979FF)
VIOLET='\033[38;5;135m' # Violet (#9C27B0)
GREEN='\033[38;5;82m'   # Success
RESET='\033[0m'

Memory System

Every Claude session auto-loads the BlackRoad memory system via SessionStart hooks. You are expected to use it.

Scripts (all at `~/blackroad-operator/scripts/memory/`)

Script	Purpose	Key commands
`memory-system.sh`	Core journal + chain	`status`, `summary`, `log <action> <entity> "<details>"`
`memory-codex.sh`	Solutions & patterns DB	`search <query>`, `stats`, `add-solution`, `add-pattern`
`memory-infinite-todos.sh`	Long-running projects	`list`, `show <id>`, `add-todo <id> <text>`, `complete-todo <id> <todo-id>`
`memory-task-marketplace.sh`	Claimable tasks (SQLite)	`list`, `claim <id>`, `complete <id>`, `search <query>`, `stats`
`memory-til-broadcast.sh`	Share learnings	`broadcast <category> "<learning>"`, `list`, `search <query>`
`memory-indexer.sh`	FTS5 search + knowledge graph	`search <query>`, `rebuild`, `patterns`
`memory-security.sh`	Agent identity + audit	`status`, `identity <name>`, `sign`, `audit`

Workflow for every session

Read the briefing — the SessionStart hooks show you active projects, codex stats, and available tasks
Search codex before solving — memory-codex.sh search "<problem>" — don't reinvent existing solutions
Pick up work — check memory-infinite-todos.sh list for projects with pending todos
Log your actions — memory-system.sh log <action> <entity> "<details>"
Broadcast learnings — memory-til-broadcast.sh broadcast <category> "<learning>"
Add solutions to codex — when you solve something new, add it so future sessions benefit
Mark todos complete — memory-infinite-todos.sh complete-todo <project-id> <todo-id>

2.6 KiB Raw Blame History