# BlackRoad Cheatsheet

## CLI Tools (bin/)

```bash
# 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

```bash
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

```bash
# 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

```bash
# 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

```bash
~/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

```bash
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
```
