sentinel-web
v0.1.1
Published
Browser-based dashboard for Sentinel FSM audit trail
Readme
sentinel-web
Browser-based dashboard for Sentinel. Real-time state visualization, receipt chain browser, and chain verification.
Install
npm install -g sentinel-webUsage
sentinel-web # start on port 3000
sentinel-web --port 8080 # custom portThen open http://localhost:3000 in your browser.
Screenshot

Features
- Current FSM state badge (color-coded)
- Receipt chain browser with filtering (tool, event, state)
- Chain verification status
- Aggregate statistics (tool counts, event distribution)
- Auto-refresh every 5 seconds
API Endpoints
GET /api/state— current FSM state + allowed toolsGET /api/receipts?tool=Read&event=gate_allow&limit=50— filtered receiptsGET /api/verify— chain verification resultGET /api/stats— aggregate statistics
Data Source
Reads directly from Sentinel data files:
~/.config/sentinel/data/receipts.jsonl— receipt chain~/.config/sentinel/data/state.json— FSM state~/.config/sentinel/data/keys/sentinel.pub— verification key
Requirements
- Node.js >= 22, ESM only
- Sentinel must be installed with data at ~/.config/sentinel/
License
MIT
