Agent skill · software engineering · aradotso
hermes-hudui-consciousness-monitor
hermes-hudui-consciousness-monitor — an agent skill for coding agents.
Why this skill is useful
Adds specific FastAPI and React patterns for real-time data handling that the AI wouldn't generate on its own.
What it needs
Requires node, python installed locally. About 8k tokens when loaded. Last updated 2026-07-09. 70 stars on the source repository.
What this skill does
React Frontend (Vite + SWR) ↓ /api/ + WebSocket /ws FastAPI Backend (Python 3.11+) ↓ collectors/.py + cache + file watcher ~/.hermes/ (agent data files) bash git clone https://github.com/joeynyc/hermes-hudui.git cd hermes-hudui python3.11 -m venv venv source venv/bin/activate ./install.sh hermes-hudui bash python3.11 -m venv venv source venv/bin/activate Install Python package pip install -e . Build frontend and copy to backend static dir cd frontend npm install npm run build cp -r dist/ ../backend/static/ Start server hermes-hudui bash source venv/bin/activate hermes-hudui bash pip install hermes-hudui[tui] python backend/collectors/identity.py from dataclasses import dataclass from pathlib import Path import json HERMESDIR = Path.home() / ".hermes" @dataclass class IdentityData: designation: str substrate: str runtime: str daysconscious: int brainsizemb: float def collectidentity() -> IdentityData: configpath = HERMESDIR / "config.json" if not configpath.exists(): return IdentityData( designation="Unknown", substrate="unknown", runtime="unknown", daysconscious=0, brainsizemb=0.0, ) data = json.loads(configpath.readtext()) return IdentityData( designation=data.get("designation", "Hermes"), substrate=data.get("substrate", "unknown"), runtime=data.get("runtime", "unknown"), daysconscious=data.get("daysconscious", 0), brainsizemb=data.get("brainsizemb", 0.0), ) python backend/main.py (simplified pattern) from fastapi import FastAPI from backend.collectors.identity import collectidentity from backend.cache import cached app = FastAPI() @app.get("/api/identity") async def identity(): return cached("identity", collectidentity) python from backend.cache import cached Simple usage — key + callable result = cached("sessions", collectsessions) With TTL override result = cached("identity", collectidentity, ttl=10) python backend/ws.py (simplified) from fastapi import WebSocket import asyncio import json connectedclients: list[WebSocket] = [] async def broadcastchange(event: s …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aradotso/hermes-hudui-consciousness-monitor