blackroad-operator

CLI tooling, node bootstrap scripts, and operational control for BlackRoad OS.

Overview

The br CLI dispatcher and all operational tooling. Routes br <command> to the right tool script. Also includes the MCP bridge server for remote AI agent access.

Structure

blackroad-operator/
├── br                # Main CLI entry point (zsh dispatcher)
├── src/              # TypeScript source
├── tools/            # 37 tool scripts (br <tool>)
├── cli-scripts/      # Standalone CLI utilities
├── mcp-bridge/       # MCP bridge server (localhost:8420)
│   ├── server.py     # FastAPI MCP server
│   └── start.sh      # Start script
├── scripts/          # Bootstrap & setup scripts
├── templates/        # Project templates
└── test/             # Tests

Quick Start

# Make br executable
chmod +x br
./br help

# Or install globally
ln -s $(pwd)/br /usr/local/bin/br
br help

Key Commands

br radar             # Context-aware suggestions
br git               # Smart git commits
br deploy            # Multi-cloud deploy
br agent             # Agent routing
br cece              # CECE identity
br help              # All 37 commands

MCP Bridge

Local MCP server for remote AI agent access:

cd mcp-bridge && ./start.sh   # Starts on 127.0.0.1:8420

Contributing

See CONTRIBUTING.md

---

© BlackRoad OS, Inc. — All rights reserved. Proprietary.