steer docs

TUI guide

The dashboard, tab by tab — keyboard, mouse, filters, context switching and live tabs.

The layout

steer tui

steer — tui

⛵ steer · aws · staging (cluster: staging-cluster)          writable ●

SERVICES        (4)
● api      2/2  v1.4
● web      3/3  v2.0
◐ worker   1/2  v1.1
○ cron     0/1  —
IMAGES          (3)
▸ api
▸ web
▸ worker
DATABASES       ···Details Events Logs
running   2/2
pending   0
status    ACTIVE
tag       v1.4
cpu·mem   0.5 vCPU · 2 GB
[d] deploy  [s] scale  [z] resize  [R] rollback
↑↓ select · tab switch panel · / filter · c context · ? help · q quit

Four zones: the top bar (cloud · context · cluster · write mode), the sidebar (services and images), the panel (tabs for the selected item) and the help bar (every shortcut, always visible).

Keyboard and mouse

Everything works both ways — this is a TUI you can actually click.

Keys	Action
`↑` `↓`	Move the selection (or scroll the panel when it has focus).
`tab`	Switch focus sidebar ↔ panel.
`←` `→`	Switch panel tab (Details / Events / Logs).
`enter` / `space`	Collapse or expand a sidebar section.
`/`	Filter the sidebar live; `esc` clears, `enter` keeps the query.
`d` `s` `z` `R`	Deploy · Scale · Resize · Rollback the selected service.
`c`	Context switcher (also: click the top bar).
`r`	Refresh services and images.
`?`	Show the full shortcut list.
`q`	Quit.

Mouse: click to select services, repos, tabs and section headers; click the action buttons; scroll with the wheel — sidebar or panel, whichever is under the cursor.

The three tabs

Details — counts, state, running tag, resources, and the action buttons. Actions open an inline form right here (type a tag, pick from the tag list, confirm).
Events — the service’s recent history at rest, refreshed while you watch. When a deploy or resize starts, the live rollout feed takes over until it finishes.
Logs — tails the last lines and follows new ones live. Scroll up to read history: new lines won’t yank you back down until you return to the bottom.

Contexts and safety

The context switcher (c or click the top bar) swaps account/environment/cloud without relaunching — sidebar, panel and capabilities reload for the new target. Contexts with writable = false show a read-only notice and block every mutating action; the buttons tell you why instead of failing silently.

No steer.toml yet? The TUI tells you exactly what to run: steer config init.