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
61 lines
2.6 KiB
Markdown
61 lines
2.6 KiB
Markdown
# 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
|
|
|
|
```bash
|
|
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
|
|
```bash
|
|
#!/bin/bash
|
|
# Description of what this script does
|
|
# Usage: ./script-name.sh [args]
|
|
|
|
set -e # Exit on error
|
|
```
|
|
|
|
### Color Constants (BlackRoad Brand)
|
|
```bash
|
|
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
|
|
|
|
1. **Read the briefing** — the SessionStart hooks show you active projects, codex stats, and available tasks
|
|
2. **Search codex before solving** — `memory-codex.sh search "<problem>"` — don't reinvent existing solutions
|
|
3. **Pick up work** — check `memory-infinite-todos.sh list` for projects with pending todos
|
|
4. **Log your actions** — `memory-system.sh log <action> <entity> "<details>"`
|
|
5. **Broadcast learnings** — `memory-til-broadcast.sh broadcast <category> "<learning>"`
|
|
6. **Add solutions to codex** — when you solve something new, add it so future sessions benefit
|
|
7. **Mark todos complete** — `memory-infinite-todos.sh complete-todo <project-id> <todo-id>`
|