Skip to content

tmustier/economist-tui

Repository files navigation

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

About

Read The Economist from your terminal using your subscription. Unofficial. Comes with CLI and SKILL.md.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors