Skip to content

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.

bash
yolo status production              # live dashboard
yolo status production --snapshot   # one frame, then exit
yolo status production --json       # structured payload for scripts

In 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 โ€‹

TabWhat it shows
OverviewPer-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 ยท SchedulerOne 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
DeploymentsRecent deployments from ECR, the running version marked; live progress while a rollout is in flight
DatabaseThe 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
CacheThe shared Valkey cache โ€” status, endpoint and engine CPU / memory / connections / evictions. Empty when the environment runs no cache
ServicesThe 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.

KeyDoes
โ—‚ โ–ธ / TabPrevious / next tab
1โ€ฆ8Jump 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 PgDnScroll the active tab's body (a group's charts + logs, deploy history)
Home / EndJump to the top / bottom of the body
qQuit

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.

Released under the MIT License.