name: economist-tui
description: Terminal UI + CLI to browse Economist headlines, search articles, and read full content in the terminal. Requires one-time browser login for full articles.

Economist TUI

Terminal app to browse and read The Economist.

Commands

# Interactive browse (TUI, type to search, ←/→ page, b back, c columns)
economist browse [section]

# Run background daemon for faster reads
economist serve

economist serve --status
economist serve --stop

# Headlines (default section: leaders)
economist headlines [section] [-n count] [-s search] [--json|--plain]

# Read full article
economist read [url|-] [--raw] [--wrap N] [--columns 1|2]

# Login (one-time, opens browser)
economist login

# List sections
economist sections

Available Sections

leaders, briefing, finance, us, britain, europe, middle-east, asia, china, americas, business, tech, science, culture, graphic, world-this-week

Global Flags

--version, --debug, --no-color

Examples

# Get 5 finance headlines
economist headlines finance -n 5

# Search for China coverage (fuzzy tokens)
economist headlines finance -s "china"

# JSON output
economist headlines finance --json

# Read article (markdown output)
economist read "https://www.economist.com/..." --raw

# Pretty terminal rendering
economist read "https://www.economist.com/..." --wrap 100

# Two-column article body
economist read "https://www.economist.com/..." --columns 2

# Debug HTML dump
economist --debug read "https://www.economist.com/..."

# Read URL from stdin
echo "https://www.economist.com/..." | economist read -

Auth Flow

1. Run economist login (opens browser)
2. Log in to Economist account
3. Browser closes automatically when login detected
4. Cookies saved to ~/.config/economist-tui/

Agent Usage

# Get headlines as JSON (for parsing)
economist headlines finance --json

# Get first headline URL
economist headlines finance --json | jq -r '.[0].url'

# Read first headline
economist headlines finance --json | jq -r '.[0].url' | xargs economist read --raw

# Plain output (title<TAB>url)
economist headlines finance --plain

Note: browse requires a TTY and won't work in agent context. Use headlines --json instead.

Notes

• Headlines via RSS: title, one-line description, date, URL (~300 items per section, ~10 months history)
• Full articles require login (headless browser with saved session cookies)
• Articles cached for 1 hour under ~/.config/economist-tui/cache
• Articles render as markdown with glamour formatting