Getting started

The Loguro TUI is a keyboard-driven console for working with your project from the terminal — live logs, alerts, pins, saved views, and inline documentation, all in one window.

It ships as part of @loguro/cli. If you already have the CLI installed and authenticated, you have the TUI.

loguro tui                          # opens at the Logs view
loguro tui --view=alerts            # jump straight to a specific view
loguro tui --app=prod               # use a configured app shortcut
loguro tui --project=happy-otter    # explicit project slug or id

The TUI uses the alternate screen buffer, so quitting it leaves your shell exactly as it was.

What you get

• Live logs with cursor, paging, pause/resume, save-as-view, instant filtering
• Pins for recurring errors (fingerprint-based, syncs with the web console)
• Saved Views to switch between common filter sets in two keystrokes
• Alerts — create, toggle, delete; derive a new alert from any log
• Docs — browse all of logu.ro/docs/* inline with full-text fuzzy search
• Health badge in the top-right showing live error-rate trend
• Command palette (:) — fuzzy-search every action and view
• Full keymap (?) — multi-section, searchable help

Every action is wired to the same backend the web console uses. Anything you do in the TUI shows up on the web, and vice versa.

First five seconds

1. loguro tui
2. Press ? — that’s the canonical keymap. Pan with ← →.
3. Press / — focus the filter bar. Type level:error @last-1h. Enter to apply.
4. Press s — save it as a named view.
5. Press 3 — open the Saved Views list. The view you just made is at the top.

Layout

Top: two-row header. First row shows loguro · <project-slug> on the left and the health badge on the right. Second row: numbered view tabs.

Middle: the current view fills the available height.

Bottom: status bar (live count, live/paused state, applied filter), search bar, shortcuts row. The shortcuts row auto-truncates to terminal width and shows +N ? if anything is hidden — press ? for the full list.

Where to next

• Views — what each numbered view does
• Keymap — every key, in one place
• Search & filtering — the filter bar and query syntax
• Alerts — create alerts from inside the TUI
• Docs browser — read these very docs from loguro tui