Status Dashboard โ
yolo status <env> opens a tabbed, read-only terminal dashboard over an environment โ live vitals, logs, deployments and the service gate in one place, polled and redrawn until you quit. It's a window, not a cockpit: there are no actions, only navigation. Every change you might want โ deploying, rolling back, managing a service โ is its own command, run as an interactive Laravel Prompts flow so the atomic task gets your full attention.
yolo status production # live dashboard
yolo status production --snapshot # one frame, then exit
yolo status production --json # structured payload for scriptsIn a real terminal the dashboard is the default. --snapshot (and any non-interactive shell โ a pipe, CI) renders a single status frame instead, and --json emits the machine-readable payload.
The frame is fitted to the terminal: the global bar and tabs sit up top, the footer stays pinned to the bottom row, and the active tab's body fills the space between. Tall content (logs, a long deploy history) clips to that space and scrolls rather than overflowing.
The tabs โ
| Tab | What it shows |
|---|---|
| Overview | Per-group vitals, load, scaling, queue backlogs and any in-flight rollout โ the same picture status --snapshot renders โ plus an app-wide CloudWatch alarms summary: the alarm count, and a row for each firing one. The full inventory (OK states and all) is one command away in status:alarms |
| Web ยท Queue ยท Scheduler | One tab per group the app actually runs โ a combined app shows only Web. Each gathers everything about that group in one place: its vitals (task counts, spec, scaling, live load), CPU / memory braille charts over the last hour (and request rate / response time for the web group), and a tail of its recent CloudWatch logs. The readable replacement for the old standalone Metrics / Logs tabs; for a longer window, the CloudWatch dashboard |
| Deployments | Recent deployments from ECR, the running version marked; live progress while a rollout is in flight |
| Database | The RDS instance or Aurora cluster the manifest database: key declares โ CPU, connections, freeable memory and latency over the last hour. YOLO reads the name from the manifest (never the app's secret .env); the tab is empty until one is declared |
| Cache | The shared Valkey cache โ status, endpoint and engine CPU / memory / connections / evictions. Empty when the environment runs no cache |
| Services | The service lifecycle: what the environment declares, which apps claim it, and its lifecycle state โ plus the Typesense cluster's live CPU / memory when it's offered |
A global health bar stays pinned at the top on every tab โ one dot per group (web / queue / scheduler), green when healthy, red when down. When a deploy is in flight it flips to a rollout banner, whoever triggered it โ your yolo deploy in another shell, CI, or a teammate's rollback. The dashboard reads that straight from ECS, so it's never out of step with what's actually rolling.
The tabs with a single primary resource โ Database, Cache, Services โ also carry a muted AWS Console deep link to it, so jumping to the full console view is one click away without cluttering the panel.
Navigating โ
| Key | Does |
|---|---|
| โ โธ / Tab | Previous / next tab |
| 1โฆ8 | Jump to a tab by number |
a tab's letter (o d b c s) | Jump straight to it. The per-group tabs (Web / Queue / Scheduler) have no letter โ reach them by number or โ โธ |
| โ โ / PgUp PgDn | Scroll the active tab's body (a group's charts + logs, deploy history) |
| Home / End | Jump to the top / bottom of the body |
| q | Quit |
A scrollable tab shows a โฒ / โผ more hint when there's content beyond the window.
Why read-only โ
The dashboard used to embed actions โ managing a service, rolling back, editing the domain โ by handing the screen to a prompt mid-loop and resuming after. That made the live view and the action feel like two apps fighting over one terminal, and a change only surfaced on the next poll. So the dashboard is now purely a window: it shows you what's happening, and you act with the matching command โ deploy, rollback, scale, services โ each an interactive Prompts flow with its own guards. One thing on screen at a time, done well.
