Docs browser

The Docs view (4) is a markdown reader for logu.ro/docs/* that runs inside the TUI. Pages are fetched on demand, cached locally for 24 hours, and full-text searchable across every page in your library.

Layout

Top: a full-width search bar with a count line below it.

Left sidebar: sectioned page list (general, commands, features, cli, tui, mcp), grouped by category prefix.

Right: the content pane. Either the doc body (when you’ve opened one) or the search results list (when you’ve typed a query).

Open a page

The current page is highlighted yellow in the sidebar (●).

Full-text search

Press / to focus the search bar. As you type, the content pane switches to a list of hits ranked by:

1. Title match
2. Slug match
3. Section match
4. Body match — score increases with more occurrences

Each result shows up to two highlighted lines (yellow on the match), with line numbers (L42).

Caching

On first open the TUI scrapes the page index from https://logu.ro/docs/ and starts a background prefetch of all pages (6 parallel requests). The sidebar shows indexing X/N while this runs.

Cache lives in ~/.config/loguro/docs-cache/ (or $XDG_CONFIG_HOME/loguro/docs-cache/). Each page is a single .md file named after its slug. Pages are considered fresh for 24 hours; after that they’re re-fetched on next open.

To force a refresh:

• r on a page → re-fetch that page
• r on the empty state → re-fetch the index, then prefetch again

Esc cascade

The Docs view owns esc (doesn’t fall through to the App’s “pop view”):

1. Search bar focused → blur + clear query
2. Query non-empty → clear query
3. Page open → close page, return to Docs root
4. No page, no query → pop the view back to whatever was beneath (usually Logs)

That way esc is always “go up one logical level”.

Why this exists

So you don’t have to switch to a browser to look up a flag, a query operator, or a config field. The TUI knows everything the web docs site knows.