Files
blackroad/CHEATSHEET.md
Alexa Amundson 60844dfa48
Some checks failed
Lint & Format / detect (push) Has been cancelled
Lint & Format / js-lint (push) Has been cancelled
Lint & Format / py-lint (push) Has been cancelled
Lint & Format / sh-lint (push) Has been cancelled
Lint & Format / go-lint (push) Has been cancelled
Add sync script, Makefile, and cheatsheet
- sync.sh: auto-syncs all sources into monorepo (cron */30)
- Makefile: health, fleet, workers, test, lint, sync, push
- CHEATSHEET.md: quick reference for CLI, SSH, workers, Gitea

BlackRoad OS — Pave Tomorrow.

RoadChain-SHA2048: 4b2b4c185280df88
RoadChain-Identity: alexa@sovereign
RoadChain-Full: 4b2b4c185280df8841f35defc9a681593131ff4e7c4fd82513c397eb6b3a557f8fe3b8cad1b0dbf3f9f2c95aa9f6cec10c39923e32483293d990fcc30921bd4f1f4c434ccadc09024af62ef6479b322645141ba47882bc9dc254e3353de653ec7ca76a3fc3dd28c8830c59ebd920a4eef7bb8232207181358f1c6b48667d895e064f3730d0eb3241bb59640a3cc3e541acdf86d28d668d1369866f3fa335877d1d021c3b86cf79452128f9573b23ed0a73937d69cf716cc816910aa6026ac23f629c358d7b7d070d2fc47ca0b4f3cae91408103ef1ba2640b074bd7b3ab021322096be861f1a1874ffbde61b11fc2041ca8f86b647a677c2552d559f4e45d837
2026-03-14 17:33:55 -05:00

1.6 KiB

BlackRoad Cheatsheet

CLI Tools (bin/)

# Ask agents
ask-alice "check DNS"           ask-cecilia "what models?"
ask-aria "container status"     ask-lucidia "remember X"

# Fleet
br-health                       # Fleet health check
br-deploy <service>             # Deploy a service
br-status                       # Fleet status

# Identity
roadid whoami                   # Show your RoadID
carpool match <task>            # Find best agent for task

# Utilities
ai <prompt>                     # Quick AI query

SSH to Nodes

ssh pi@192.168.4.49             # Alice (gateway)
ssh blackroad@192.168.4.96      # Cecilia (AI)
ssh pi@192.168.4.101            # Octavia (git)
ssh blackroad@192.168.4.98      # Aria (orchestration)
ssh octavia@192.168.4.38        # Lucidia (memory)

Workers

# Deploy
cd workers && npx wrangler deploy

# Health
curl https://pay.blackroad.io/health
curl https://auth.blackroad.io/health

# Logs
cd ~/roadcode-squad && npx wrangler tail

Gitea

# API
curl -H "Authorization: token TOKEN" https://git.blackroad.io/api/v1/repos/search

# Clone
git clone https://git.blackroad.io/blackroad-os/blackroad.git

Memory System

~/blackroad-operator/scripts/memory/memory-system.sh status
~/blackroad-operator/scripts/memory/memory-codex.sh search "problem"
~/blackroad-operator/scripts/memory/memory-til-broadcast.sh list

Make Commands

make help      # Show all commands
make health    # Check worker health
make fleet     # Ping all nodes
make sync      # Sync monorepo
make push      # Sync + push to Gitea
make lint      # Lint everything