Skip to content

README.md

Latest commit

 

History

History
83 lines (57 loc) · 1.88 KB

README.md

File metadata and controls

83 lines (57 loc) · 1.88 KB
Raw

Economist TUI

Responsive Terminal UI and CLI to browse and read The Economist with your subscription. Unofficial.

  • economist browse starts the TUI with current headlines (requires login with economist login)
  • economist demo starts the TUI with pre-loaded archived articles

Demo

Demo

Browsing archived articles in economist demo mode

Install

Homebrew (macOS)

brew install tmustier/tap/economist-tui

From source

git clone https://github.com/tmustier/economist-tui
cd economist-tui

# Build local binary
make
./economist --version

# Install to ~/bin (macOS codesign included)
make install

Prereqs: Go 1.25+, Chrome/Chromium (for login and article fetching).

Quick start

# Login (one-time, for full articles)
economist login

# Demo mode (no login required)
economist demo

# Interactive Terminal UI
economist browse
economist browse finance

# Non-interactive
economist headlines leaders --json
economist read "https://www.economist.com/finance-and-economics/2026/01/19/article-slug" --raw

Commands

  • login — open browser to authenticate
  • browse [section] — interactive TUI (defaults to Leaders)
    • Enter read article, b back, type to search
    • c toggle columns on/off, Esc clear, q quit
  • demo — interactive TUI with demo content (no login required)
  • headlines [section] — list headlines
    • -n/--number, -s/--search, --json, --plain
  • read [url|-] — read full article (--raw, --wrap, --columns)
  • sections — list sections

Global flags: --version, --debug, --no-color

Configuration

Config + cookies: ~/.config/economist-tui/ Cache: ~/.config/economist-tui/cache (1h TTL)

Notes

  • RSS provides ~300 items per section (~10 months)
  • Full articles require an active Economist subscription

License

MIT