Skip to content

x402agent/SolanaOS / skills/os-hub

os-hub

Verified

SolanaOS Hub — skill registry, gateway management, and control UI. Use when managing skills via ClawHub CLI, connecting to the SolanaOS gateway (TCP bridge on port 18790, WebSocket on port 18793), or working with the Lit-based control UI at ui/.

SolanaOS Hub

Central hub for skill management, gateway operations, and the control UI.

Architecture

┌──────────────────┐     ┌────────────────────┐     ┌──────────────────┐
│   Control UI     │────▶│   Gateway Bridge   │────▶│   Headless Nodes │
│  (Lit + Vite)    │ WS  │  (Go TCP Server)   │ TCP │  (Orin/RPi/etc)  │
│  ui/             │     │  pkg/gateway/       │     │                  │
└──────────────────┘     └────────────────────┘     └──────────────────┘
     Port 5173 (dev)        Port 18790 (bridge)
                            Port 18793 (WS/canvas)

Key Codebase Paths

ComponentPathDescription
Gateway Bridgepkg/gateway/bridge.goTCP server, node auth, JSON-line protocol
Gateway WebSocketpkg/gateway/ws.goWebSocket transport for browser clients
Control UIui/Lit web components, Vite build, connects via WS
UI Gateway Clientui/src/ui/gateway.tsWebSocket client with device auth
Skillsskills/All operator skills (this directory)

Control UI

The control UI is a Lit web component app at ui/.

Dev Server

cd /Users/8bit/solanaos/ui && npm run dev

Build

cd /Users/8bit/solanaos/ui && npm run build

Test

cd /Users/8bit/solanaos/ui && npm test

UI connects to gateway via WebSocket

The UI uses solanaos-gateway subprotocol to communicate with the Go gateway. See ui/src/ui/gateway.ts for the client implementation. Protocol frames:

  • hello-ok — auth handshake with device token
  • event — server-push events (presence, health, state)
  • res — request/response pairs

Gateway

The Go-native gateway at pkg/gateway/ provides:

  • TCP Bridge (port 18790): JSON-line protocol for headless nodes
  • WebSocket (port 18793): Browser/extension connections
  • Auth: Token-based + device identity signing (Ed25519)
  • Canvas Host: Serves HTML to connected nodes

Start Gateway

cd /Users/8bit/solanaos && go build -ldflags="-s -w" -o build/solanaos . && ./build/solanaos node gateway-spawn

Configuration

In ~/.solanaos/solanaos.json:

{
  "gateway": {
    "bind": "auto",
    "port": 18790,
    "authToken": "your-token"
  },
  "canvasHost": {
    "enabled": true,
    "port": 18793,
    "root": "~/clawd/canvas"
  }
}

ClawHub CLI (Skill Registry)

Install

npm i -g clawhub

Auth (publish)

clawhub login
clawhub whoami

Search

clawhub search "postgres backups"

Install

clawhub install my-skill
clawhub install my-skill --version 1.2.3

Update (hash-based match + upgrade)

clawhub update my-skill
clawhub update my-skill --version 1.2.3
clawhub update --all
clawhub update my-skill --force
clawhub update --all --no-input --force

List

clawhub list

Publish

clawhub publish ./my-skill --slug my-skill --name "My Skill" --version 1.2.0 --changelog "Fixes + docs"

Notes

  • Default registry: https://clawhub.com (override with CLAWHUB_REGISTRY or --registry)
  • Default workdir: cwd (falls back to SolanaOS workspace); install dir: ./skills (override with --workdir / --dir / CLAWHUB_WORKDIR)
  • Update command hashes local files, resolves matching version, and upgrades to latest unless --version is set
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 197kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 197kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 197kUpdated Claude CodeCodexVerifiedInstall