cloudflare-project

Hub for the projects deployed on Cloudflare. Shared tools live in the hub Worker; this page is the notes board: how things connect, live status, and ideas.

Live status

Project	Kind	Status	Origin
Loading from the hub…

Architecture

 Browser
   │
   ├── Pages sites (static): github-manager, agon-agent, claudebridge, x-os
   ├── Workers: xenarth, aura-signals
   └── Hub Worker (cf-hub)
         ├── /projects, /projects/status   registry + live health
         ├── POST /tools/:name             shared tools (hub.ping, hub.echo, projects.list)
         └── /p/:id/*                      forwards to that project's origin

Shared code lives in packages/shared (helpers, tool definitions, project registry). The hub bundles it. Projects adopt it by importing it once their repo is updated; the six project repos are not modified yet.

How to call the hub

curl https://cf-hub.justinsimpsad.workers.dev/projects/status
curl -X POST https://cf-hub.justinsimpsad.workers.dev/tools/hub.echo -H 'content-type: application/json' -d '{"hello":"hub"}'
curl https://cf-hub.justinsimpsad.workers.dev/p/xenarth/

Ideas

Give every project one login by putting Cloudflare Access in front of the hub routes.
Move shared state (notes, settings) into a D1 or KV binding once the token has storage permissions.
Expose each project's own API through /p/:id/api/* so the other projects can call it.
Add a cron Worker that pings /projects/status and records outages.

Open items

Secrets not set yet: xenarth needs its AI and GitHub keys; aura-signals needs Supabase keys. Features that need them are skipped until set.
github-manager, claudebridge, and agon-agent are static builds. Their server-side API routes (api/) are not running on Cloudflare.
The GitHub token pasted in chat should be rotated.