Skip to content

tui.md

Latest commit

 

History

History
59 lines (42 loc) · 2.29 KB

tui.md

File metadata and controls

59 lines (42 loc) · 2.29 KB

TUI Guide

The interactive Terminal UI provides a keyboard-driven interface for browsing HackerNews without leaving the terminal.

Launching

postcli-hn tui

Or via the PostCLI main CLI:

postcli hn tui

Tabs

Tab Description
Stories Browse stories by type (top, new, best, ask, show, job). Navigate the list and open individual stories to see details and comments.
Comments View recent comments across HN. Open a comment to see its parent context and reply thread.
Search Search stories by keyword. Type your query and browse results inline.
Profile View your profile (when authenticated) or look up other users by username. Shows karma, join date, and submission count.

Keybindings

Key Action
tab Switch between tabs
1-6 Jump to story type (top, new, best, ask, show, job) in Stories tab
up / k Move selection up
down / j Move selection down
enter Open selected item (story detail, comment thread)
r Reply to the selected comment or story (requires auth)
u Upvote the selected item (requires auth)
o Open the selected item in your default browser
/ Focus the search input (in Search tab)
n Next page of results
p Previous page of results
q / esc Go back or quit

Navigation

The TUI uses a stack-based navigation model. Press enter to drill into an item and esc or q to go back. At the top level, q exits the application.

In the Stories tab, selecting a story opens a detail view showing the full title, URL, score, author, and the top comments. From there you can reply to comments or upvote.

In the Comments tab, selecting a comment shows the parent story context and the reply thread below the selected comment.

Authentication in the TUI

The TUI respects the same authentication as the CLI. If you have logged in via postcli-hn auth login, write operations (reply, upvote) are available in the TUI. Without auth, browsing and reading work normally.

Tips

  • Use --json on the CLI for scripting; the TUI is for interactive browsing
  • The TUI fetches data on demand as you navigate, so an internet connection is required
  • Story type switching (keys 1-6) is only active in the Stories tab