@loguro/cli 1.0.4 → 1.1.1

package/README.md

@@ -142,13 +142,13 @@ loguro pin            Pin recurring logs to track (📌 marker auto-shown on lis
 loguro share          Create / list / revoke public markdown shares of logs (single or multi-log)
 ```
 
-### Interactive mode
+### Interactive mode (legacy, `logs -i`)
 
 ```
 loguro logs --interactive   # or -i
 ```
 
-Opens a TUI navigator over your logs:
+The original one-shot TUI navigator built on top of `loguro logs`:
 
 - `↑↓` / `jk` navigate, `enter` to inspect a log, `esc` back
 - `/` live fuzzy search (highlights matches; prefix `=` for exact substring)
@@ -163,7 +163,57 @@ In log detail:
 - `s` create public share, URL auto-copied to clipboard
 - `c` copy log ID, `o` open in web console, `j` toggle JSON-colored context
 
-All actions wired to the same backend endpoints as the standalone commands. Pipe-friendly: without `-i` everything stays plain text streamable.
+Pipe-friendly: without `-i` everything stays plain text streamable.
+
+### TUI (multi-view app, `loguro tui`)
+
+```
+loguro tui                          # opens at Logs view
+loguro tui --view=saved-views       # jump straight to a specific view
+loguro tui --app=prod               # use a configured app shortcut
+```
+
+A persistent multi-view Ink app. Unlike `logs -i` (one shot, one feed), `loguro tui` is a small terminal app with view stack, navigation, command palette, and shared search state. Press `?` inside for the full keybinding reference (multi-section, navigable with ← →).
+
+**Views**
+- **Logs** (`1`) — live tail with cursor + paging. Scroll position, applied filter and live/pause state survive when you go into a detail view and come back. `space` toggles live polling (green ● live, yellow ⏸ paused).
+- **Pins** (`2`) — manage pinned logs (fingerprint-based). Resolve / mark-watching / delete inline.
+- **Saved Views** (`3`) — backend-synced saved filters (same store the web console uses). `enter` to apply, `d` to delete. Create new ones from Logs with `s`.
+- **Docs** (`4`) — browse `logu.ro/docs/*` inline. `/` fuzzy-search across all pages, `enter` opens, `tab` switches focus list/body, `r` refreshes cache. Markdown is rendered with headings/code/lists/quotes. Cached locally for 24h in `~/.config/loguro/docs-cache/`.
+- **Alerts** (`5`) — list / toggle / delete project alerts. `c` opens the create-alert wizard (name → channel → levels → message-substring → cooldown). You can also derive an alert from a log: open the log and press `a` to start the wizard with name/level/message pre-filled.
+- **Log detail** — `a` create alert from this log (wizard pre-filled with name/level/message), `p` pin, `t` trace, `c` copy id, `o` open in web, `j` JSON view, `y` copy full JSON.
+- **Trace** — every log sharing a trace id, in order.
+- **Command palette** (`:`) — fuzzy-search every registered action and view by title/keyword.
+
+**Global keys**
+- `1` / `2` / `3` / `4` / `5` — switch to Logs / Pins / Saved Views / Docs / Alerts
+- `/` — focus search bar (filter logs by the same query syntax as the web)
+- `:` — command palette
+- `?` — multi-section help (this is the source of truth for every key)
+- `q` — pop one view from the stack
+- `Q` — quit the TUI
+- `esc` — close overlay / unfocus search / pop view
+
+**Logs navigation**
+- `↑/↓` or `j/k` — move by 1
+- `ctrl+↑/↓` — jump 10 lines
+- `g` / `G` — top / bottom
+- `n` — next page (older logs)
+- `r` — reload
+- `space` — pause / resume live tail
+- `s` — save current filter as a saved view
+- `v` — open Saved Views list
+- `x` — clear current filter
+
+**Filter syntax**
+
+Same as the web console: `level:error @last-1h !context.env:staging "payment timeout"`. The search bar offers static completions today (filter keys + common operators); live values are next.
+
+**Layout**
+
+Top: a two-row header — first row shows `loguro · <slug>` on the left and a **health badge** on the right (`✓ healthy 3% →` / `⚠ warning 8% ↑` / `✗ critical 25% ↑` / `· idle` for empty projects). The badge polls every 60s, derived from the error-rate trend over the last 20 minutes. Second row: view tabs. Bottom: status bar (item count, live state, applied query), search bar, shortcuts row. The shortcuts row auto-truncates to terminal width and shows `+N ?` if anything was hidden — open `?` for the full keymap.
+
+All actions hit the same backend endpoints as the standalone commands. Anything you do in the TUI (pins, saved views, alerts, etc.) shows up on the web too.
 
 ### Zero-UI workflow