Web UI control surface for Hero OS VMs: services, AI keys, upgrades, and docs.
  • Rust 75.5%
  • HTML 24.5%
Find a file
mik-tf 331f01d164
All checks were successful
lab publish / publish (push) Successful in 33m49s
feat(cockpit): add release-channel service updates
Signed-by: mik-tf <mik-tf@noreply.invalid>
2026-06-10 00:46:28 -04:00
.forgejo/workflows feat(cockpit): add apps and admin surfaces 2026-06-09 22:23:05 -04:00
crates feat(cockpit): add release-channel service updates 2026-06-10 00:46:28 -04:00
.gitignore feat(scaffold): hero_cockpit s133 — 5-crate workspace from hero_template 2026-05-21 07:55:09 -04:00
Cargo.lock cockpit: build from main + migrate to relocated hero_lib API 2026-06-03 15:17:13 -04:00
Cargo.toml chore(cockpit): apply lab rust version policy 2026-06-09 22:30:03 -04:00
README.md cockpit: rename demo to Hero OS Tester Sandbox in user-facing copy 2026-05-27 14:07:15 -04:00
rust-toolchain.toml cockpit: build from main + migrate to relocated hero_lib API 2026-06-03 15:17:13 -04:00

hero_cockpit

End-user control surface for a Hero OS Tester Sandbox VM. Lets the user see / start / stop services, set BYO AI keys, trigger upgrades, submit feedback, and read the manual via a simple web UI.

Spec: hero_cockpit#1 — architecture, page inventory, API surface, per-user manifest format. Arc tracker: lhumina_code/home#235 (Hero OS demo-deployer arc).

Workspace shape

Five crates, scaffolded from hero_template:

Crate Binary Socket Purpose
hero_cockpit hero_cockpit Lifecycle CLI (--start / --stop / --info)
hero_cockpit_server hero_cockpit_server hero_cockpit/rpc.sock OpenRPC backend (service state, BYO keys, upgrade, feedback)
hero_cockpit_sdk (lib) Generated typed client
hero_cockpit_admin hero_cockpit_admin hero_cockpit/admin.sock Admin dashboard
hero_cockpit_web hero_cockpit_web hero_cockpit/web.sock End-user web UI

Quick start

# Build the workspace via lab
lab build hero_cockpit --release --install

# Start the stack via hero_proc
hero_cockpit --start

# Or via lab service
lab service hero_cockpit --install --start

Endpoints

Each daemon serves these:

  • GET /health — liveness probe
  • GET /.well-known/heroservice.json — service manifest

The server additionally serves POST /rpc (JSON-RPC 2.0 — cockpit.* methods).

Status

  • s133: scaffold (5 crates, service.toml × 4 daemons, /health + /.well-known endpoints, cargo check + lab infocheck clean). The real API surface lands in s134-s139.

License

Apache-2.0