Web Admin & TUI Consoles
Manage your engine via the rich browser Web Admin at /_moul_/ or the terminal-native Bubble Tea TUI (moul-ctl).
Moul provides two dedicated administrative interfaces to manage and inspect your running moul engine:
- Web Admin Console (
/_moul_/): Modern responsive browser dashboard embedded directly intomoul. - Moul Terminal User Interface (
moul-ctl): Fast, keyboard-driven CLI console built with Charm's Bubble Tea.
1. Web Admin Console (/_moul_/)
Accessed at http://localhost:8090/_moul_/ (or your production domain).
Architecture & Capabilities
- Frontend Stack: Built on Moul UI (
@moul-dev/ui), React Aria Components, and StyleX for atomic compile-time CSS-in-JS. - Visual Schema Designer: Drag-and-drop field modeling, real-time expression validator, and relationship configuration.
- Data Browser & Grid: Full-screen paginated record explorer with dynamic filtering, sorting, and inline editing.
- Live Worker Queue Monitor: Inspect running jobs, retry failed items from DLQ, or discard pending tasks.
- Telemetry Charts: Interactive request latency, throughput, and error rate graphs.
- Real-Time Stream Viewer: Server-Sent Events (SSE) live logs viewer with syntax highlighting and auto-follow.
- Feature Flag Playground: Test gate targeting rules against custom JSON payloads with live reason code breakdowns.
- Form Divergence Guards:
AlertDialogconfirmation dialogs protect against unsaved settings loss.
2. Moul TUI Console (moul-ctl)
The TUI provides complete headless server administration directly from your command line.
Launching the TUI
# Launch interactive connection prompt
moul-ctlOn first launch, enter your server URL (http://localhost:8090 or remote URL) and your MOUL_ADMIN_KEY. Credentials are saved securely to ~/.config/moul.json for subsequent runs.
# Connect directly by specifying server and admin key
moul-ctl -server http://localhost:8090 -admin-key test-admin-key-1234# Launch via moul convenience subcommand
moul ctlCLI Options
| Flag | Description | Example |
|---|---|---|
-server <url> | moul server URL | -server https://api.myapp.com |
-admin-key <key> | Master administrative key | -admin-key my-secret-key |
update, -u, --update | Self-update moul-ctl binary to the latest release | moul-ctl update |
-f, --force | Force update even if already at latest version | moul-ctl update -f |
-v, --version | Print version information and exit | moul-ctl --version |
TUI Keyboard Shortcuts Reference
| Screen | Key | Action |
|---|---|---|
| Global | ctrl+c | Exit program |
| Dashboard | ↑ / ↓ (or k / j) | Navigate collections & menu items |
Enter / l / → | Open selected item | |
r | Refresh schemas from server | |
Esc | Disconnect and return to connection screen | |
| Record List | ↑ / ↓ (or k / j) | Scroll records list |
> / < | Next / Previous page | |
/ | Activate live search & filter query | |
Enter / v | Inspect JSON payload | |
n | Create new record | |
e | Edit selected record | |
d | Delete selected record | |
| Record / Job Detail | c | Copy JSON payload to OS clipboard |
Esc / q | Return to list | |
| Worker Monitor | r | Force-retry failed job |
c | Discard / cancel job | |
f | Refresh worker status immediately | |
| Settings Panel | ← / → | Switch settings tabs |
R | Trigger instant server-side hot-reload |