sysadminandClaude Opus 4.8
a8fcf0e01c
Starlette read-only MVP with shared layout, /health JSON liveness, and route stubs for projects, prompts, runtime, audit, worktrees, and leases. Includes scripts/run-webui, docs/webui-local-dev.md, and tests. Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>
1.3 KiB
1.3 KiB
Internal web UI — local development (#426)
Read-only MVP skeleton for the MCP Control Plane operator console. Gitea,
MCP capability gates, and skills/llm-project-workflow/ remain the source of
truth; this UI only provides route stubs and layout.
Prerequisites
- Python 3.11+ with project dependencies installed (
pip install -r requirements.txt) - No secrets in repo, config, or client bundle
Start the server
From the repository root (or an issue worktree):
./scripts/run-webui
Or directly:
python3 -m webui
Optional environment variables:
| Variable | Default | Purpose |
|---|---|---|
WEBUI_HOST |
127.0.0.1 |
Bind address (keep local for MVP) |
WEBUI_PORT |
8765 |
Listen port |
Routes (MVP)
| Path | Description |
|---|---|
/ |
Home / operator overview |
/health |
JSON liveness (status, service, mode, timestamp) |
/projects |
Stub — registry (#427) |
/prompts |
Stub — prompt library (#428) |
/runtime |
Stub — MCP runtime health (#430) |
/audit |
Stub — report audit paste (#431) |
/worktrees |
Stub — hygiene dashboard (#432) |
/leases |
Stub — lease visibility (#433) |
All routes are GET-only. POST/PUT/PATCH/DELETE return 405 with
read-only-mvp.
Tests
pytest tests/test_webui_skeleton.py -q