Browse TUI

reedle browse opens a full-screen, three-pane terminal interface — no external dependencies required. Navigate your library, read articles with rendered markdown, and manage everything (star, archive, delete, tag) without leaving the terminal.

Layout

3-pane layout

┌─ Views ────┬─ Articles [42] ──────────────────┬─ Preview ───────────────┐
│ ◉ All (39) │ ★    My Great Article   arxiv  2d │ My Great Article        │
│ ★ Starred │      Another Article   blog   5d │                         │
│   Archived │      A Third Article   nature 1w │ arxiv.org · 2d ago      │
│ ─ TAGS ─   │                                  │ ★ Starred  #research    │
│ #research  │                                  │                         │
│ #ai        │                                  │ This is the excerpt...  │
│ ─ LISTS ─  │                                  │                         │
│  Reading   │                                  │ Enter: read  s:★        │
└────────────┴──────────────────────────────────┴─────────────────────────┘
│ Enter: read  s:★  a:archive  d:delete  t:tag  o:browser  /: search     │
└─────────────────────────────────────────────────────────────────────────┘

Launch

Terminal

reedle browse              # All articles (archived hidden)
reedle browse --starred    # Starred only
reedle browse -t research  # Filter by tag
reedle browse -l <list_id> # Filter by reading list

Navigation

Key	Action
`j / k` or `↑ / ↓`	Move cursor up / down in focused pane
`Tab`	Cycle focus: sidebar → articles → preview → sidebar
`1 / 2 / 3`	Jump directly to sidebar / articles / preview
`g / G`	Jump to first / last article
`PgUp / PgDn`	Page up / down in focused pane
`Enter`	Open article in fullscreen reader (from list or preview)
`Enter` (sidebar)	Filter article list by selected view / tag / list
`r`	Refresh — re-fetch articles from API
`q` or `Ctrl-C`	Quit TUI

Search

Key	Action
`/`	Enter search mode — live filter by title, site, excerpt, or tag
Type	Narrows article list in real-time
`Enter`	Confirm search and resume navigation
`Esc`	Cancel search and restore full list

Article actions

Actions work when the article list pane is focused.

Key	Action
`s`	Toggle star on selected article
`a`	Toggle archive on selected article
`d`	Delete — press `d` once to arm, again to confirm. `Esc` cancels.
`t`	Add tag — opens a prompt. Tag is lowercased and space-normalized.
`o`	Open article in browser (web app)

Fullscreen reader

Press Enter on any article to enter fullscreen reading mode. Content is fetched from the API and rendered as formatted markdown.

Key	Action
`j / k`	Scroll down / up (3 lines)
`Space / PgDn`	Scroll down (20 lines)
`PgUp`	Scroll up (20 lines)
`o`	Open article in browser
`b` or `Esc` or `q`	Exit reader — return to 3-pane view

Markdown rendering

The fullscreen reader renders markdown using marked + marked-terminal, bundled with reedle-cli — no external tools required. If the renderer fails for any reason, the raw text is displayed as a fallback.

Setup

# Install reedle-cli — browse works out of the box
npm install -g reedle-cli
reedle browse

Sidebar views

View	Shows
◉ All	All non-archived articles
★ Starred	Starred articles only
Archived	Archived articles only
#tag	Articles with that tag
List name	Articles in that reading list